Scopes

from honcho import Honcho

honcho = Honcho(workspace_id="my-app")

# Get or create — idempotent; passing metadata updates the existing scope
therapy = honcho.scope("therapy")

# Add existing sessions (max 100 per call)
therapy.add_sessions(["therapy-session-1", "therapy-session-2"])

# Or attach at session creation — the scope is created if it doesn't exist
session = honcho.session("therapy-session-3", scopes=["therapy"])

# Inspect
for s in therapy.sessions():
    print(s.id)

therapy.remove_session("therapy-session-1")

for scope in honcho.scopes():
    print(scope.id, scope.metadata)

import { Honcho } from "@honcho-ai/sdk";

const honcho = new Honcho({ workspaceId: "my-app" });

// Get or create — idempotent; passing metadata updates the existing scope
const therapy = await honcho.scope("therapy");

// Add existing sessions (max 100 per call)
await therapy.addSessions(["therapy-session-1", "therapy-session-2"]);

// Or attach at session creation — the scope is created if it doesn't exist
const session = await honcho.session("therapy-session-3", {
  scopes: ["therapy"],
});

// Inspect
for await (const s of await therapy.sessions()) {
  console.log(s.id);
}

await therapy.removeSession("therapy-session-1");

for await (const scope of await honcho.scopes()) {
  console.log(scope.id, scope.metadata);
}

# Get or create (201 created / 200 existing)
curl -X POST "$HONCHO_URL/v3/workspaces/my-app/scopes" \
  -H "Authorization: Bearer $HONCHO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": "therapy"}'

# Add sessions
curl -X POST "$HONCHO_URL/v3/workspaces/my-app/scopes/therapy/sessions" \
  -H "Authorization: Bearer $HONCHO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"session_ids": ["therapy-session-1", "therapy-session-2"]}'

# List membership
curl -X POST "$HONCHO_URL/v3/workspaces/my-app/scopes/therapy/sessions/list" \
  -H "Authorization: Bearer $HONCHO_API_KEY"

# Remove one session
curl -X DELETE "$HONCHO_URL/v3/workspaces/my-app/scopes/therapy/sessions/therapy-session-1" \
  -H "Authorization: Bearer $HONCHO_API_KEY"

therapy.add_sessions(["old-session-with-history"])

status = therapy.status()
# {"old-session-with-history": {"state": "pending", "updated_at": "..."}}
# → later: {"state": "completed", "docs_copied": 42, "updated_at": "..."}

await therapy.addSessions(["old-session-with-history"]);

const status = await therapy.status();
// { "old-session-with-history": { state: "pending", updatedAt: "..." } }

curl "$HONCHO_URL/v3/workspaces/my-app/scopes/therapy/status" \
  -H "Authorization: Bearer $HONCHO_API_KEY"

# Chat — answered only from the therapy sessions
answer = user.chat("What is stressing them out?", scope="therapy")

# Representation
rep = user.representation(scope="therapy")

# Session context, using the scope as the perspective source
ctx = session.context(peer_target="user-123", scope="therapy")

# Message search, restricted to the scope's sessions
messages = honcho.search("insomnia", scope="therapy")

// Chat — answered only from the therapy sessions
const answer = await user.chat("What is stressing them out?", {
  scope: "therapy",
});

// Representation
const rep = await user.representation({ scope: "therapy" });

// Session context, using the scope as the perspective source
const ctx = await session.context({
  peerTarget: "user-123",
  scope: "therapy",
});

// Message search, restricted to the scope's sessions
const messages = await honcho.search("insomnia", { scope: "therapy" });

curl -X POST "$HONCHO_URL/v3/workspaces/my-app/peers/user-123/chat" \
  -H "Authorization: Bearer $HONCHO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What is stressing them out?", "scope": "therapy"}'