@aui.io/apollo 0.1.4

package/node_modules/@aui.io/apollo-core/dist/src/services/clients.js

@@ -0,0 +1,95 @@
+import { homedir } from "node:os";
+import { IdentityClient } from "../api/identity.js";
+import { AgentSettingsClient } from "../api/agent-settings.js";
+import { ManagementClient } from "../api/management.js";
+import { RuntimeApiClient } from "../api/runtime-api.js";
+import { Transport } from "../api/transport.js";
+import { readCredentials, writeCredentials, } from "../config/index.js";
+import { AuthError } from "../errors/index.js";
+function expiry(token) {
+    try {
+        const payload = token.split(".")[1];
+        if (!payload)
+            return undefined;
+        const claims = JSON.parse(Buffer.from(payload, "base64url").toString("utf8"));
+        return claims.exp ? new Date(claims.exp * 1_000).toISOString() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function createClients(context, options = {}) {
+    const homeDir = options.homeDir ?? homedir();
+    const identityTransport = new Transport({
+        service: "identity",
+        baseUrl: context.baseUrls.identity,
+        timeoutMs: context.timeoutMs,
+        authHeader: "x-access-token",
+        ...(context.token ? { token: context.token } : {}),
+        ...(options.fetch ? { fetch: options.fetch } : {}),
+    });
+    const identity = new IdentityClient(identityTransport);
+    let refreshPromise;
+    const refresh = async () => {
+        if (!refreshPromise) {
+            refreshPromise = (async () => {
+                const credentials = await readCredentials(homeDir);
+                const current = credentials[context.profile]?.[context.environment];
+                if (!current?.refresh_token) {
+                    throw new AuthError("The session expired and has no refresh token.");
+                }
+                let refreshed;
+                try {
+                    refreshed = await identity.refresh(current.refresh_token);
+                }
+                catch {
+                    throw new AuthError("The session expired and could not be refreshed.", "Run `apollo login` and try again.");
+                }
+                const next = {
+                    ...current,
+                    access_token: refreshed.token,
+                    refresh_token: refreshed.refreshToken,
+                    ...(expiry(refreshed.token) ? { expires_at: expiry(refreshed.token) } : {}),
+                };
+                credentials[context.profile] ??= {};
+                credentials[context.profile][context.environment] = next;
+                await writeCredentials(homeDir, credentials);
+                return refreshed.token;
+            })().finally(() => {
+                refreshPromise = undefined;
+            });
+        }
+        return refreshPromise;
+    };
+    const common = {
+        timeoutMs: context.timeoutMs,
+        ...(context.token ? { token: context.token } : {}),
+        refresh,
+        ...(options.fetch ? { fetch: options.fetch } : {}),
+    };
+    const managementTransport = new Transport({
+        service: "apollo-api",
+        baseUrl: context.baseUrls.management,
+        userId: context.userId,
+        ...common,
+    });
+    const runtimeTransport = new Transport({
+        service: "runtime-api",
+        baseUrl: context.baseUrls.runtime,
+        ...common,
+    });
+    const agentSettingsTransport = new Transport({
+        service: "agent-settings",
+        baseUrl: context.baseUrls.agentSettings,
+        orgId: context.orgId,
+        orgHeader: "X-Organization-ID",
+        ...common,
+    });
+    return {
+        identity,
+        management: new ManagementClient(managementTransport),
+        runtime: new RuntimeApiClient(runtimeTransport),
+        agentSettings: new AgentSettingsClient(agentSettingsTransport),
+    };
+}
+//# sourceMappingURL=clients.js.map

package/node_modules/@aui.io/apollo-core/dist/src/services/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../../src/services/clients.ts"],"names":[],"mappings":"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"}

package/node_modules/@aui.io/apollo-core/dist/src/services/env.service.d.ts

@@ -0,0 +1,11 @@
+import { type Environment } from "../config/index.js";
+export interface EnvironmentResult {
+    environment: Environment;
+    changed: boolean;
+}
+export interface EnvironmentSummary {
+    environment: Environment;
+    active: boolean;
+}
+export declare function setEnvironment(value: string, current: Environment, profile: string, homeDir?: string): Promise<EnvironmentResult>;
+export declare function listEnvironments(current: Environment): EnvironmentSummary[];

package/node_modules/@aui.io/apollo-core/dist/src/services/env.service.js

@@ -0,0 +1,19 @@
+import { homedir } from "node:os";
+import { parseEnvironment, readCredentials, updateEnvironment, } from "../config/index.js";
+import { ConfigError } from "../errors/index.js";
+export async function setEnvironment(value, current, profile, homeDir = homedir()) {
+    const environment = parseEnvironment(value);
+    const credentials = await readCredentials(homeDir);
+    if (!credentials[profile]?.[environment]) {
+        throw new ConfigError(`Profile "${profile}" is not logged in to ${environment}.`, `Run \`apollo login --env ${environment}\` while profile "${profile}" is active.`);
+    }
+    await updateEnvironment(homeDir, environment);
+    return { environment, changed: environment !== current };
+}
+export function listEnvironments(current) {
+    return ["staging", "production", "eu"].map((environment) => ({
+        environment,
+        active: environment === current,
+    }));
+}
+//# sourceMappingURL=env.service.js.map

package/node_modules/@aui.io/apollo-core/dist/src/services/env.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.service.js","sourceRoot":"","sources":["../../../src/services/env.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYjD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAa,EACb,OAAoB,EACpB,OAAe,EACf,OAAO,GAAG,OAAO,EAAE;IAEnB,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,WAAW,CACnB,YAAY,OAAO,yBAAyB,WAAW,GAAG,EAC1D,4BAA4B,WAAW,qBAAqB,OAAO,cAAc,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC9C,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAoB;IACnD,OAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAA0B,CAAC,GAAG,CAClE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAChB,WAAW;QACX,MAAM,EAAE,WAAW,KAAK,OAAO;KAChC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/node_modules/@aui.io/apollo-core/dist/src/services/hierarchy.d.ts

@@ -0,0 +1,29 @@
+import type { IdentityClient, Organization } from "../api/identity.js";
+import type { Agent, ManagementClient, Project } from "../api/management.js";
+import { type Context, type ProjectBinding } from "../config/index.js";
+export declare function listOrganizations(identity: IdentityClient): Promise<Organization[]>;
+export declare function useOrganization(context: Context, identity: IdentityClient, organizationId: string): Promise<{
+    token: string;
+    refreshToken?: string;
+}>;
+export declare function listProjects(management: ManagementClient, name?: string): Promise<{
+    results: Project[];
+}>;
+export declare function useProject(context: Context, management: ManagementClient, projectId: string, cwd: string): Promise<{
+    project: Project;
+    binding: ProjectBinding;
+}>;
+export declare function createProject(context: Context, management: ManagementClient, name: string, cwd: string): Promise<{
+    project: Project;
+    binding: ProjectBinding;
+}>;
+export declare function listAgents(context: Context, management: ManagementClient, name?: string): Promise<{
+    results: Agent[];
+}>;
+export declare function useAgent(context: Context, management: ManagementClient, agentId: string, cwd: string): Promise<{
+    agent: Agent;
+    binding: ProjectBinding;
+}>;
+export declare function createAgent(context: Context, management: ManagementClient, name: string): Promise<Agent>;
+export declare function bindAgent(context: Context, agent: Agent, cwd: string): Promise<ProjectBinding>;
+export declare function unlinkAgent(context: Context, cwd: string): Promise<ProjectBinding>;

package/node_modules/@aui.io/apollo-core/dist/src/services/hierarchy.js

@@ -0,0 +1,117 @@
+import path from "node:path";
+import { writeBinding, } from "../config/index.js";
+import { ConfigError } from "../errors/index.js";
+import { setActiveProject } from "../workspace/store.js";
+function bindingPath(context, cwd) {
+    return context.bindingPath ?? path.join(cwd, ".apollorc");
+}
+function usesWorkspaceProjectSelection(context) {
+    return Boolean(context.workspaceRoot &&
+        (context.bindingFromWorkspace || !context.bindingPath));
+}
+async function updateBinding(context, cwd, patch) {
+    const binding = {
+        config_version: 1,
+        ...(context.orgId ? { org_id: context.orgId } : {}),
+        ...(context.projectId ? { project_id: context.projectId } : {}),
+        ...(context.agentId ? { agent_id: context.agentId } : {}),
+        ...(context.versionTag ? { version_tag: context.versionTag } : {}),
+        ...patch,
+    };
+    for (const [key, value] of Object.entries(binding)) {
+        if (value === undefined) {
+            delete binding[key];
+        }
+    }
+    await writeBinding(bindingPath(context, cwd), binding);
+    return binding;
+}
+async function selectProject(context, cwd, project) {
+    if (usesWorkspaceProjectSelection(context)) {
+        if (!context.workspaceRoot) {
+            throw new ConfigError("No workspace is selected.");
+        }
+        await setActiveProject(context.workspaceRoot, project.id);
+        return {
+            config_version: 1,
+            ...(context.orgId ? { org_id: context.orgId } : {}),
+            project_id: project.id,
+        };
+    }
+    // Keep agent checkout identity intact; only agent unlink clears it.
+    return updateBinding(context, cwd, {
+        project_id: project.id,
+    });
+}
+export async function listOrganizations(identity) {
+    return identity.listOrganizations();
+}
+export async function useOrganization(context, identity, organizationId) {
+    const tokens = await identity.switchOrganization(organizationId);
+    const token = tokens.token ?? context.token;
+    if (!token) {
+        throw new ConfigError("Identity did not return an organization-scoped token.");
+    }
+    return {
+        token,
+        ...(tokens.refreshToken ? { refreshToken: tokens.refreshToken } : {}),
+    };
+}
+export async function listProjects(management, name) {
+    const page = await management.listProjects();
+    if (!name)
+        return page;
+    // The management API ignores query filters on /projects, so filter here.
+    const wanted = name.toLowerCase();
+    return {
+        ...page,
+        results: page.results.filter((project) => project.name.toLowerCase().includes(wanted)),
+    };
+}
+export async function useProject(context, management, projectId, cwd) {
+    const project = await management.getProject(projectId);
+    const binding = await selectProject(context, cwd, project);
+    return { project, binding };
+}
+export async function createProject(context, management, name, cwd) {
+    const project = await management.createProject(name);
+    const binding = await selectProject(context, cwd, project);
+    return { project, binding };
+}
+export async function listAgents(context, management, name) {
+    if (!context.projectId)
+        throw new ConfigError("Select a project first.");
+    // Unlike /projects, the agents endpoint filters by name server-side.
+    return management.listAgents(context.projectId, name);
+}
+export async function useAgent(context, management, agentId, cwd) {
+    const agent = await management.getAgent(agentId);
+    const binding = await updateBinding(context, cwd, {
+        project_id: agent.project_id,
+        agent_id: agent.id,
+        ...(agent.live_version_id ? { version_tag: agent.live_version_id } : {}),
+    });
+    return { agent, binding };
+}
+export async function createAgent(context, management, name) {
+    if (!context.projectId)
+        throw new ConfigError("Select a project first.");
+    return management.createAgent(context.projectId, name);
+}
+export async function bindAgent(context, agent, cwd) {
+    const binding = {
+        config_version: 1,
+        ...(context.orgId ? { org_id: context.orgId } : {}),
+        project_id: agent.project_id,
+        agent_id: agent.id,
+    };
+    await writeBinding(path.join(cwd, ".apollorc"), binding);
+    return binding;
+}
+export async function unlinkAgent(context, cwd) {
+    return updateBinding(context, cwd, {
+        agent_id: undefined,
+        version_tag: undefined,
+    });
+}
+//# sourceMappingURL=hierarchy.js.map

package/node_modules/@aui.io/apollo-core/dist/src/services/hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.js","sourceRoot":"","sources":["../../../src/services/hierarchy.ts"],"names":[],"mappings":"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"}

package/node_modules/@aui.io/apollo-core/dist/src/services/messaging.d.ts

@@ -0,0 +1,17 @@
+import type { Message, RuntimeApiClient, RuntimeTrace, SendMessageResponse, Thread } from "../api/runtime-api.js";
+import type { Context } from "../config/index.js";
+export declare function parseVariables(values?: string[]): Record<string, unknown>;
+export declare function sendMessage(context: Context, runtime: RuntimeApiClient, input: {
+    text: string;
+    threadId?: string;
+    versionId?: string;
+    variables?: string[];
+    localDir?: string;
+    includeTrace?: boolean;
+}): Promise<SendMessageResponse>;
+export declare function createThread(context: Context, runtime: RuntimeApiClient, versionId?: string): Promise<Thread>;
+export declare function getThread(runtime: RuntimeApiClient, threadId: string): Promise<Thread>;
+export declare function listThreads(context: Context, runtime: RuntimeApiClient, page?: number, size?: number): Promise<Thread[]>;
+export declare function listMessages(runtime: RuntimeApiClient, threadId: string): Promise<Message[]>;
+export declare function trace(runtime: RuntimeApiClient, threadId: string, interactionId?: string): Promise<RuntimeTrace | RuntimeTrace[]>;
+export declare function debugInteraction(runtime: RuntimeApiClient, interactionId: string): Promise<Record<string, unknown>>;

package/node_modules/@aui.io/apollo-core/dist/src/services/messaging.js

@@ -0,0 +1,99 @@
+import path from "node:path";
+import { readProgramFiles } from "../bundle/files.js";
+import { assembleBundle } from "../bundle/materialize.js";
+import { assertValidProgram, mapRuntimeValidation, } from "../bundle/validate.js";
+import { AuthError, ConfigError } from "../errors/index.js";
+function requireAgent(context) {
+    if (!context.agentId)
+        throw new ConfigError("Select or import an agent first.");
+    return context.agentId;
+}
+/**
+ * The end-user id stamped on every message and thread (runtime-api's
+ * core_user_id). It is always the signed-in platform user from the token —
+ * never a literal like "cli" and never caller-supplied — so conversations are
+ * attributable to a real account.
+ */
+function requireUserId(context) {
+    if (!context.userId) {
+        throw new AuthError("The stored credential has no user id.", "Run `apollo login` again to refresh it.");
+    }
+    return context.userId;
+}
+export function parseVariables(values = []) {
+    const variables = {};
+    for (const value of values) {
+        const separator = value.indexOf("=");
+        if (separator < 1)
+            throw new ConfigError(`Expected KEY=VALUE, received: ${value}`);
+        const key = value.slice(0, separator);
+        const raw = value.slice(separator + 1);
+        try {
+            variables[key] = JSON.parse(raw);
+        }
+        catch {
+            variables[key] = raw;
+        }
+    }
+    return variables;
+}
+export async function sendMessage(context, runtime, input) {
+    const agentId = context.agentId;
+    if (!agentId && !input.localDir) {
+        throw new ConfigError("Select or import an agent, or pass --local.");
+    }
+    let inlineBundle;
+    if (input.localDir) {
+        const requestedRoot = path.resolve(input.localDir);
+        const localAgentRoot = context.agentRoot && requestedRoot === path.resolve(process.cwd())
+            ? context.agentRoot
+            : requestedRoot;
+        const program = await readProgramFiles(path.join(localAgentRoot, "bundle", "src"));
+        assertValidProgram(mapRuntimeValidation(await runtime.validateProgram({ files: program.files })));
+        inlineBundle = assembleBundle(program.files);
+    }
+    return runtime.sendMessage(agentId, {
+        text: input.text,
+        user_id: requireUserId(context),
+        ...(input.threadId ? { thread_id: input.threadId } : {}),
+        agent_variables: parseVariables(input.variables),
+        ...(agentId
+            ? {
+                agent: {
+                    agent_id: agentId,
+                    ...(input.versionId ? { version_id: input.versionId } : {}),
+                    ...(context.versionTag ? { version_tag: context.versionTag } : {}),
+                },
+            }
+            : {}),
+        ...(inlineBundle ? { agent_settings_bundle: inlineBundle } : {}),
+        include_trace: input.includeTrace ?? false,
+    });
+}
+export function createThread(context, runtime, versionId) {
+    return runtime.createThread({
+        agentId: requireAgent(context),
+        ...(versionId ? { versionId } : {}),
+        ...(context.versionTag ? { versionTag: context.versionTag } : {}),
+        userId: requireUserId(context),
+        environment: context.environment,
+    });
+}
+export function getThread(runtime, threadId) {
+    return runtime.getThread(threadId);
+}
+export function listThreads(context, runtime, page, size) {
+    return runtime.listThreads(requireUserId(context), page, size);
+}
+export function listMessages(runtime, threadId) {
+    return runtime.listMessages(threadId);
+}
+export function trace(runtime, threadId, interactionId) {
+    return interactionId
+        ? runtime.interactionTrace(interactionId)
+        : runtime.threadTrace(threadId);
+}
+export function debugInteraction(runtime, interactionId) {
+    return runtime.interactionDebug(interactionId);
+}
+//# sourceMappingURL=messaging.js.map

package/node_modules/@aui.io/apollo-core/dist/src/services/messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.js","sourceRoot":"","sources":["../../../src/services/messaging.ts"],"names":[],"mappings":"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"}

package/node_modules/@aui.io/apollo-core/dist/src/services/mockdb.d.ts

@@ -0,0 +1,71 @@
+import { MockDbClient, type MockDbProvisionResponse, type MockDbTokenAuth } from "../api/mock-db.js";
+import type { Context } from "../config/index.js";
+import { keyPrefixes } from "../config/mockdb-keys.js";
+export interface MockDbServiceOptions {
+    agentId?: string;
+    accountId?: string;
+    homeDir?: string;
+    fetch?: typeof globalThis.fetch;
+}
+export interface MockDbResolved {
+    context: Context;
+    client: MockDbClient;
+    agentId: string;
+    agentRoot?: string;
+    tokenAuth: MockDbTokenAuth;
+    homeDir: string;
+}
+export declare function resolveMockDb(context: Context, options?: MockDbServiceOptions): MockDbResolved;
+export declare function provisionMockDb(context: Context, options?: MockDbServiceOptions): Promise<MockDbProvisionResponse & {
+    stored: ReturnType<typeof keyPrefixes>;
+}>;
+export declare function describeMockDb(context: Context, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function statusMockDb(context: Context, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function createCollection(context: Context, name: string, schema: unknown, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function listCollections(context: Context, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function updateCollection(context: Context, name: string, addColumns: unknown[], options?: MockDbServiceOptions): Promise<unknown>;
+export declare function seedRows(context: Context, collection: string, rows: unknown[], options?: MockDbServiceOptions): Promise<unknown>;
+export declare function createEndpoint(context: Context, body: Record<string, unknown>, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function listEndpoints(context: Context, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function getEndpoint(context: Context, slug: string, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function updateEndpoint(context: Context, slug: string, body: Record<string, unknown>, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function deleteEndpoint(context: Context, slug: string, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function executeEndpoint(context: Context, slug: string, input?: {
+    session?: string;
+    body?: unknown;
+}, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function inspectSession(context: Context, sessionKey: string, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function resetSession(context: Context, sessionKey: string, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function rotateMgmtKey(context: Context, options?: MockDbServiceOptions): Promise<MockDbProvisionResponse & {
+    stored: ReturnType<typeof keyPrefixes>;
+}>;
+export declare function rotateRuntimeKey(context: Context, options?: MockDbServiceOptions): Promise<MockDbProvisionResponse & {
+    stored: ReturnType<typeof keyPrefixes>;
+    rewireRequired: true;
+}>;
+export declare function exportMockDb(context: Context, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function deleteMockDb(context: Context, options?: MockDbServiceOptions): Promise<unknown>;
+export declare function storedKeys(context: Context, options?: MockDbServiceOptions): Promise<ReturnType<typeof keyPrefixes> & {
+    agentId: string;
+}>;
+export interface WireResult {
+    agentId: string;
+    path: string;
+    connectionId: string;
+    tokenEnv: string;
+    baseUrl: string;
+    runtimeKey?: string;
+    hint: string;
+}
+/**
+ * Ensure `connections.yaml` has a mock-db connection that points at this agent's
+ * execute base and reads the runtime key from MOCKDB_TOKEN (vault later).
+ */
+export declare function wireMockDbConnection(context: Context, options?: MockDbServiceOptions & {
+    connectionId?: string;
+    tokenEnv?: string;
+}): Promise<WireResult>;
+export declare function parseJsonFlag(flag: string, raw: string): unknown;
+export declare function normalizeSchema(raw: unknown): {
+    columns: unknown[];
+};