@tidblink/server 0.3.0-rc.0 → 0.4.0-rc.0

package/examples/organization-session.mjs

@@ -1,66 +0,0 @@
-import { pathToFileURL } from "node:url";
-import { OrganizationClient } from "@tidblink/server";
-
-/** Retain the owner, selected Template/model and both creation identities before calling. */
-export async function organizationSessionWorkflow({
-  baseUrl,
-  organizationApiKey,
-  userId,
-  agentTemplateId,
-  agentCreationKey,
-  sessionCreationKey,
-  model,
-}) {
-  const organization = new OrganizationClient({
-    baseUrl,
-    apiKey: organizationApiKey,
-  });
-  const user = organization.user(userId);
-  const templates = await user.listAgentTemplates();
-  const models = await user.listModels();
-  const agent = await user.createAgent({
-    agentTemplateId,
-    idempotencyKey: agentCreationKey,
-  });
-  const session = await agent.createSession({
-    idempotencyKey: sessionCreationKey,
-    ...(model === undefined ? {} : { model }),
-  });
-  return { organization, user, agent, session, templates, models };
-}
-
-if (
-  process.argv[1] &&
-  import.meta.url === pathToFileURL(process.argv[1]).href
-) {
-  const {
-    AGENT_SERVICE_URL,
-    ORGANIZATION_API_KEY,
-    END_USER_ID,
-    TEMPLATE_ID,
-    AGENT_CREATION_KEY,
-    SESSION_CREATION_KEY,
-    MODEL_ID,
-  } = process.env;
-  if (
-    !AGENT_SERVICE_URL ||
-    !ORGANIZATION_API_KEY ||
-    !END_USER_ID ||
-    !TEMPLATE_ID ||
-    !AGENT_CREATION_KEY ||
-    !SESSION_CREATION_KEY
-  )
-    throw new Error(
-      "Set AGENT_SERVICE_URL, ORGANIZATION_API_KEY, END_USER_ID, TEMPLATE_ID, AGENT_CREATION_KEY and SESSION_CREATION_KEY; MODEL_ID is optional",
-    );
-  const { agent, session } = await organizationSessionWorkflow({
-    baseUrl: AGENT_SERVICE_URL,
-    organizationApiKey: ORGANIZATION_API_KEY,
-    userId: END_USER_ID,
-    agentTemplateId: TEMPLATE_ID,
-    agentCreationKey: AGENT_CREATION_KEY,
-    sessionCreationKey: SESSION_CREATION_KEY,
-    model: MODEL_ID,
-  });
-  console.log(JSON.stringify({ agentId: agent.id, sessionId: session.id }));
-}

package/examples/provision-user.mjs

@@ -1,83 +0,0 @@
-import { open } from "node:fs/promises";
-import { pathToFileURL } from "node:url";
-import {
-  ConflictError,
-  OrganizationClient,
-  OutcomeUnknownError,
-} from "@tidblink/server";
-
-/** Each successful invocation issues a new credential. Retain it in your secret manager. */
-export async function provisionUser({
-  baseUrl,
-  organizationApiKey,
-  externalId,
-  displayName,
-}) {
-  const client = new OrganizationClient({
-    baseUrl,
-    apiKey: organizationApiKey,
-  });
-  const organization = await client.getOrganization();
-  const mapping = externalId.trim();
-  if (!mapping)
-    throw new TypeError("externalId is required for reconciliation");
-  const find = async () =>
-    (await client.listEndUsers()).find((user) => user.externalId === mapping);
-  let user = await find();
-  if (!user) {
-    try {
-      user = await client.createEndUser({
-        externalId: mapping,
-        ...(displayName === undefined ? {} : { displayName }),
-      });
-    } catch (error) {
-      if (
-        !(error instanceof OutcomeUnknownError) &&
-        !(error instanceof ConflictError && error.code === "resource_conflict")
-      )
-        throw error;
-      user = await find().catch(() => undefined);
-      if (!user) throw error;
-    }
-  }
-  // Metadata cannot recover a lost token. This issuance is deliberately never repeated here.
-  const issued = await client.createUserApiKey(user.userId, {
-    name: "application-backend",
-  });
-  return { organization, user, ...issued };
-}
-
-if (
-  process.argv[1] &&
-  import.meta.url === pathToFileURL(process.argv[1]).href
-) {
-  const {
-    AGENT_SERVICE_URL,
-    ORGANIZATION_API_KEY,
-    END_USER_EXTERNAL_ID,
-    USER_CREDENTIAL_FILE,
-  } = process.env;
-  if (
-    !AGENT_SERVICE_URL ||
-    !ORGANIZATION_API_KEY ||
-    !END_USER_EXTERNAL_ID ||
-    !USER_CREDENTIAL_FILE
-  ) {
-    throw new Error(
-      "Set AGENT_SERVICE_URL, ORGANIZATION_API_KEY, END_USER_EXTERNAL_ID and USER_CREDENTIAL_FILE",
-    );
-  }
-  // Reserve a new private destination before issuing a credential; never overwrite an existing secret.
-  const destination = await open(USER_CREDENTIAL_FILE, "wx", 0o600);
-  try {
-    const result = await provisionUser({
-      baseUrl: AGENT_SERVICE_URL,
-      organizationApiKey: ORGANIZATION_API_KEY,
-      externalId: END_USER_EXTERNAL_ID,
-    });
-    await destination.writeFile(JSON.stringify(result) + "\n");
-    console.log("User credential saved to USER_CREDENTIAL_FILE");
-  } finally {
-    await destination.close();
-  }
-}

package/examples/schedule-task.mjs

@@ -1,67 +0,0 @@
-import { setTimeout as delay } from "node:timers/promises";
-import { pathToFileURL } from "node:url";
-import { UserClient } from "@tidblink/server";
-
-/** Persist the exact runAt, prompt and creation key before calling. */
-export async function scheduleTaskWorkflow({
-  baseUrl,
-  userApiKey,
-  agentId,
-  idempotencyKey,
-  runAt,
-  prompt,
-  title = "Scheduled task",
-  timeoutMs = 30000,
-}) {
-  const user = new UserClient({ baseUrl, apiKey: userApiKey });
-  const created = await user.schedulers.create({
-    agentId,
-    idempotencyKey,
-    title,
-    prompt,
-    schedule: { kind: "once", runAt },
-  });
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    const { fires } = await user.schedulers.fires(
-      created.scheduler.schedulerId,
-    );
-    const fire = fires.find((item) => item.executionStatus !== "pending");
-    if (fire) {
-      const turn =
-        fire.result.sessionId && fire.result.turnId
-          ? await user
-              .session(fire.result.sessionId)
-              .getTurn(fire.result.turnId)
-          : null;
-      return { scheduler: created.scheduler, fire, turn };
-    }
-    await delay(100);
-  }
-  throw new Error(
-    `Waiting stopped; read Scheduler ${created.scheduler.schedulerId} fires later. Its schedule remains active.`,
-  );
-}
-
-if (
-  process.argv[1] &&
-  import.meta.url === pathToFileURL(process.argv[1]).href
-) {
-  try {
-    const result = await scheduleTaskWorkflow({
-      baseUrl: process.env.AGENT_SERVICE_URL,
-      userApiKey: process.env.USER_API_KEY,
-      agentId: process.env.AGENT_ID,
-      idempotencyKey: process.env.SCHEDULER_IDEMPOTENCY_KEY,
-      runAt: process.env.SCHEDULE_RUN_AT,
-      prompt: process.env.SCHEDULE_PROMPT,
-    });
-    console.log(JSON.stringify(result));
-    if (result.fire.executionStatus === "failed") process.exitCode = 1;
-  } catch (error) {
-    console.error(
-      error instanceof Error ? error.message : "Scheduled task failed",
-    );
-    process.exitCode = 1;
-  }
-}