@opengeni/contracts 0.44.1 → 1.0.0

package/dist/session-list-entries.d.ts

@@ -0,0 +1,4 @@
+import type { Session, SessionListEntry } from "./index.js";
+/** Explicit list projection. Detail/configuration remains available from getSession. */
+export type SessionListEntryInput = Omit<SessionListEntry, "displayTitle" | "renameSeed" | "scheduledTaskId" | "siteOrigin" | "pinned" | "pinnedAt" | "pinVersion" | "unread" | "activelyWorking" | "attentionVersion" | "archived" | "archivedAt" | "archiveVersion"> & Partial<Pick<Session, "pinned" | "pinnedAt" | "pinVersion" | "unread" | "activelyWorking" | "attentionVersion" | "archived" | "archivedAt" | "archiveVersion">> & Pick<Session, "metadata" | "initialMessage">;
+export declare function sessionListEntry(session: SessionListEntryInput): SessionListEntry;

package/dist/session-list-entries.js

@@ -0,0 +1,51 @@
+import {
+  deriveAutomaticSessionTitlePreview,
+  deriveSessionDisplayTitle,
+  sessionTitleIsPending
+} from "./chunk-2ACYHZFB.js";
+
+// src/session-list-entries.ts
+function sessionListEntry(session) {
+  const origin = session.metadata._opengeniSiteOrigin;
+  const siteOrigin = origin && typeof origin.siteId === "string" && /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i.test(origin.siteId) && typeof origin.title === "string" ? { siteId: origin.siteId, title: origin.title } : null;
+  const scheduledTaskId = session.metadata.scheduledTaskId;
+  return {
+    id: session.id,
+    workspaceId: session.workspaceId,
+    accountId: session.accountId,
+    status: session.status,
+    backgroundCommandActivity: session.backgroundCommandActivity,
+    hasSchedules: session.hasSchedules,
+    title: session.title,
+    titleSource: session.titleSource,
+    displayTitle: deriveSessionDisplayTitle(session),
+    renameSeed: sessionTitleIsPending(session) ? deriveAutomaticSessionTitlePreview(session.initialMessage) ?? "" : session.title?.trim() ?? "",
+    scheduledTaskId: typeof scheduledTaskId === "string" && scheduledTaskId.length > 0 ? scheduledTaskId : null,
+    siteOrigin,
+    createdBy: session.createdBy,
+    channelId: session.channelId,
+    parentSessionId: session.parentSessionId,
+    rootSessionId: session.rootSessionId,
+    effectiveControl: session.effectiveControl,
+    inputWait: session.inputWait,
+    lastSequence: session.lastSequence,
+    pinned: session.pinned ?? false,
+    pinnedAt: session.pinnedAt ?? null,
+    pinVersion: session.pinVersion ?? 0,
+    unread: session.unread ?? false,
+    activelyWorking: session.activelyWorking ?? false,
+    attentionVersion: session.attentionVersion ?? 0,
+    archived: session.archived ?? false,
+    archivedAt: session.archivedAt ?? null,
+    importedArchive: session.importedArchive,
+    archiveVersion: session.archiveVersion ?? 0,
+    treeStats: session.treeStats,
+    requiresActionSince: session.requiresActionSince,
+    createdAt: session.createdAt,
+    updatedAt: session.updatedAt
+  };
+}
+export {
+  sessionListEntry
+};
+//# sourceMappingURL=session-list-entries.js.map

package/dist/session-list-entries.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-list-entries.ts"],"sourcesContent":["import type { Session, SessionListEntry } from \"./index\";\nimport {\n  deriveAutomaticSessionTitlePreview,\n  deriveSessionDisplayTitle,\n  sessionTitleIsPending,\n} from \"./session-titles\";\n\n/** Explicit list projection. Detail/configuration remains available from getSession. */\nexport type SessionListEntryInput = Omit<\n  SessionListEntry,\n  | \"displayTitle\"\n  | \"renameSeed\"\n  | \"scheduledTaskId\"\n  | \"siteOrigin\"\n  | \"pinned\"\n  | \"pinnedAt\"\n  | \"pinVersion\"\n  | \"unread\"\n  | \"activelyWorking\"\n  | \"attentionVersion\"\n  | \"archived\"\n  | \"archivedAt\"\n  | \"archiveVersion\"\n> &\n  Partial<\n    Pick<\n      Session,\n      | \"pinned\"\n      | \"pinnedAt\"\n      | \"pinVersion\"\n      | \"unread\"\n      | \"activelyWorking\"\n      | \"attentionVersion\"\n      | \"archived\"\n      | \"archivedAt\"\n      | \"archiveVersion\"\n    >\n  > &\n  Pick<Session, \"metadata\" | \"initialMessage\">;\n\nexport function sessionListEntry(session: SessionListEntryInput): SessionListEntry {\n  const origin = session.metadata._opengeniSiteOrigin as\n    | { siteId?: unknown; title?: unknown }\n    | undefined;\n  const siteOrigin =\n    origin &&\n    typeof origin.siteId === \"string\" &&\n    /^[\\da-f]{8}-[\\da-f]{4}-[\\da-f]{4}-[\\da-f]{4}-[\\da-f]{12}$/i.test(origin.siteId) &&\n    typeof origin.title === \"string\"\n      ? { siteId: origin.siteId, title: origin.title }\n      : null;\n  const scheduledTaskId = session.metadata.scheduledTaskId;\n  return {\n    id: session.id,\n    workspaceId: session.workspaceId,\n    accountId: session.accountId,\n    status: session.status,\n    backgroundCommandActivity: session.backgroundCommandActivity,\n    hasSchedules: session.hasSchedules,\n    title: session.title,\n    titleSource: session.titleSource,\n    displayTitle: deriveSessionDisplayTitle(session),\n    renameSeed: sessionTitleIsPending(session)\n      ? (deriveAutomaticSessionTitlePreview(session.initialMessage) ?? \"\")\n      : (session.title?.trim() ?? \"\"),\n    scheduledTaskId:\n      typeof scheduledTaskId === \"string\" && scheduledTaskId.length > 0 ? scheduledTaskId : null,\n    siteOrigin,\n    createdBy: session.createdBy,\n    channelId: session.channelId,\n    parentSessionId: session.parentSessionId,\n    rootSessionId: session.rootSessionId,\n    effectiveControl: session.effectiveControl,\n    inputWait: session.inputWait,\n    lastSequence: session.lastSequence,\n    pinned: session.pinned ?? false,\n    pinnedAt: session.pinnedAt ?? null,\n    pinVersion: session.pinVersion ?? 0,\n    unread: session.unread ?? false,\n    activelyWorking: session.activelyWorking ?? false,\n    attentionVersion: session.attentionVersion ?? 0,\n    archived: session.archived ?? false,\n    archivedAt: session.archivedAt ?? null,\n    importedArchive: session.importedArchive,\n    archiveVersion: session.archiveVersion ?? 0,\n    treeStats: session.treeStats,\n    requiresActionSince: session.requiresActionSince,\n    createdAt: session.createdAt,\n    updatedAt: session.updatedAt,\n  };\n}\n"],"mappings":";;;;;;;AAwCO,SAAS,iBAAiB,SAAkD;AACjF,QAAM,SAAS,QAAQ,SAAS;AAGhC,QAAM,aACJ,UACA,OAAO,OAAO,WAAW,YACzB,6DAA6D,KAAK,OAAO,MAAM,KAC/E,OAAO,OAAO,UAAU,WACpB,EAAE,QAAQ,OAAO,QAAQ,OAAO,OAAO,MAAM,IAC7C;AACN,QAAM,kBAAkB,QAAQ,SAAS;AACzC,SAAO;AAAA,IACL,IAAI,QAAQ;AAAA,IACZ,aAAa,QAAQ;AAAA,IACrB,WAAW,QAAQ;AAAA,IACnB,QAAQ,QAAQ;AAAA,IAChB,2BAA2B,QAAQ;AAAA,IACnC,cAAc,QAAQ;AAAA,IACtB,OAAO,QAAQ;AAAA,IACf,aAAa,QAAQ;AAAA,IACrB,cAAc,0BAA0B,OAAO;AAAA,IAC/C,YAAY,sBAAsB,OAAO,IACpC,mCAAmC,QAAQ,cAAc,KAAK,KAC9D,QAAQ,OAAO,KAAK,KAAK;AAAA,IAC9B,iBACE,OAAO,oBAAoB,YAAY,gBAAgB,SAAS,IAAI,kBAAkB;AAAA,IACxF;AAAA,IACA,WAAW,QAAQ;AAAA,IACnB,WAAW,QAAQ;AAAA,IACnB,iBAAiB,QAAQ;AAAA,IACzB,eAAe,QAAQ;AAAA,IACvB,kBAAkB,QAAQ;AAAA,IAC1B,WAAW,QAAQ;AAAA,IACnB,cAAc,QAAQ;AAAA,IACtB,QAAQ,QAAQ,UAAU;AAAA,IAC1B,UAAU,QAAQ,YAAY;AAAA,IAC9B,YAAY,QAAQ,cAAc;AAAA,IAClC,QAAQ,QAAQ,UAAU;AAAA,IAC1B,iBAAiB,QAAQ,mBAAmB;AAAA,IAC5C,kBAAkB,QAAQ,oBAAoB;AAAA,IAC9C,UAAU,QAAQ,YAAY;AAAA,IAC9B,YAAY,QAAQ,cAAc;AAAA,IAClC,iBAAiB,QAAQ;AAAA,IACzB,gBAAgB,QAAQ,kBAAkB;AAAA,IAC1C,WAAW,QAAQ;AAAA,IACnB,qBAAqB,QAAQ;AAAA,IAC7B,WAAW,QAAQ;AAAA,IACnB,WAAW,QAAQ;AAAA,EACrB;AACF;","names":[]}

package/dist/session-mcp-projections.d.ts

@@ -0,0 +1,215 @@
+import type { SessionGoalStatus, SessionStatus } from "./session-topology-primitives.js";
+import type { WorkDiscoveryProjection } from "./work-claims.js";
+import type { Session, SessionQueueSnapshot } from "./index.js";
+/** MCP-only presentation choice. REST/SDK session shapes keep their own defaults. */
+export type SessionMcpDetail = "compact" | "full";
+/** Search evidence is inseparable from matching; presentation opts never weaken search. */
+export declare function sessionMcpIncludesRelatedWork(options: {
+    detail?: SessionMcpDetail | undefined;
+    includeRelatedWork?: boolean | undefined;
+    query?: string | undefined;
+    subject?: unknown;
+}): boolean;
+/** A database prefix plus its exact Unicode code-point count, not a JS UTF-16 count. */
+export declare function boundSessionMcpText(value: string | null, maxChars?: number, originalChars?: number | null): {
+    text: null;
+    truncated: boolean;
+} | {
+    text: string;
+    truncated: boolean;
+};
+export type SessionMcpControlSource = {
+    state: string;
+    primaryBlocker: {
+        kind: "session" | "workspace";
+        sessionId?: string | undefined;
+        displayName: string;
+        displayNameOriginalChars?: number;
+        reason?: string | null;
+    } | null;
+    additionalBlockerCount: number;
+};
+/** Call only after related-access projection: this helper never grants ancestor access. */
+export declare function compactSessionMcpPause(control: SessionMcpControlSource): {
+    state: string;
+    source?: {
+        kind: "session" | "workspace";
+        sessionId?: string;
+        displayName: string | null;
+        displayNameTruncated?: boolean;
+        reason?: string | null;
+        reasonTruncated?: boolean;
+    };
+    additionalBlockerCount?: number;
+} | undefined;
+export type SessionMcpListSource = {
+    channelId?: string | null;
+    id: string;
+    title: string | null;
+    titleOriginalChars?: number | null;
+    status: SessionStatus;
+    parentSessionId: string | null;
+    effectiveControl: SessionMcpControlSource;
+    goal: {
+        status: SessionGoalStatus;
+        text: string;
+        textOriginalChars?: number;
+    } | null;
+    updatedAt: string;
+    workDiscovery?: WorkDiscoveryProjection;
+    treeStats?: {
+        attentionDescendants: number;
+        pausedDescendants: number;
+        failedDescendants: number;
+        truncated: boolean;
+    };
+};
+/** Closed allowlist, shared by MCP adapters. Never spread a database/session object. */
+export declare function compactSessionMcpListRow(session: SessionMcpListSource, includeRelatedWork?: boolean): {
+    id: string;
+    projectId?: string;
+    title: string | null;
+    status: "cancelled" | "failed" | "idle" | "queued" | "recovering" | "requires_action" | "running" | "waiting_capacity";
+    titleTruncated?: boolean;
+    parentSessionId?: string;
+    goal?: {
+        status: "active" | "completed" | "paused";
+        summary: string | null;
+        summaryTruncated?: boolean;
+    };
+    pause?: {
+        state: string;
+        source?: {
+            kind: "session" | "workspace";
+            sessionId?: string;
+            displayName: string | null;
+            displayNameTruncated?: boolean;
+            reason?: string | null;
+            reasonTruncated?: boolean;
+        };
+        additionalBlockerCount?: number;
+    };
+    attention?: {
+        requiresActionDescendants?: number;
+        pausedDescendants?: number;
+        failedDescendants?: number;
+        truncated?: boolean;
+    };
+    relatedWork?: {
+        claims: {
+            id: string;
+            sessionId: string;
+            subject: {
+                namespace: string;
+                type: "artifact" | "branch" | "ci_run" | "issue" | "other" | "pull_request" | "release" | "repository";
+                canonicalKey: string;
+                displayLabel: string | null;
+            };
+            role: "delivering" | "monitoring" | "reviewing" | "working";
+            state: "active" | "released" | "stale" | "superseded";
+            revision: number;
+            provenance: "explicit_agent" | "session_resource" | "system_lifecycle" | "trusted_integration" | "user_api";
+            version: {
+                kind: "artifact_version" | "branch_head" | "ci_run" | "git_commit" | "other" | "pull_request_head" | "release_version";
+                value: string;
+            } | null;
+            observedAt: string;
+            updatedAt: string;
+            settledAt: string | null;
+        }[];
+        claimsTruncated: boolean;
+        match: {
+            class: "exact_subject" | "fuzzy" | "goal" | "title";
+            field: "claim_key" | "claim_label" | "goal" | "subject" | "title";
+            scoreBand: "exact" | "related" | "strong";
+            claimId: string | null;
+        } | null;
+        possibleOverlap: boolean;
+        advisoryOnly: true;
+        noAdditionalAccess: true;
+    };
+    updatedAt: string;
+};
+export type SessionMcpMonitoringSource = {
+    goal: {
+        status: SessionGoalStatus;
+        text: string;
+        textOriginalChars: number;
+        evidence: string | null;
+        evidenceOriginalChars: number | null;
+        rationale: string | null;
+        rationaleOriginalChars: number | null;
+        pausedReason: string | null;
+        pausedReasonOriginalChars: number | null;
+    } | null;
+    progress: {
+        sequence: number;
+        text: string | null;
+        /** Null when a bounded encoded prefix cannot establish the original code-point count. */
+        originalChars: number | null;
+        textTruncated?: true;
+        occurredAt: string;
+    } | null;
+    wait: {
+        reason: string;
+        until: string;
+    } | null;
+};
+/** Closed management projection shared by adapters; never includes session configuration.
+ * Apply target/ancestor authorization projection to session before calling. */
+export declare function compactSessionMcpDetail(session: Session, monitoring: SessionMcpMonitoringSource, queue: SessionQueueSnapshot | null): {
+    id: string;
+    projectId?: string;
+    title: string | null;
+    status: "cancelled" | "failed" | "idle" | "queued" | "recovering" | "requires_action" | "running" | "waiting_capacity";
+    titleTruncated?: boolean;
+    parentSessionId?: string;
+    activeTurnId?: string;
+    lastSequence: number;
+    goal?: {
+        status: "active" | "completed" | "paused";
+        summary: string | null;
+        summaryTruncated?: boolean;
+        evidence?: string | null;
+        evidenceTruncated?: true;
+        pausedReason?: string | null;
+        pausedReasonTruncated?: true;
+        rationale?: string | null;
+        rationaleTruncated?: true;
+    };
+    progress?: {
+        sequence: number;
+        text: string | null;
+        occurredAt: string;
+        textTruncated?: boolean;
+    };
+    pause?: {
+        state: string;
+        source?: {
+            kind: "session" | "workspace";
+            sessionId?: string;
+            displayName: string | null;
+            displayNameTruncated?: boolean;
+            reason?: string | null;
+            reasonTruncated?: boolean;
+        };
+        additionalBlockerCount?: number;
+    };
+    wait?: {
+        reason: string | null;
+        until: string;
+        reasonTruncated?: boolean;
+    };
+    queue?: {
+        queuedTurns: number;
+        pendingInputs: number;
+        stoppingPreviousAttempt?: boolean;
+    };
+    stopping?: {
+        attempts?: number;
+        backgroundCommands?: number;
+    };
+    updatedAt: string;
+};
+export type SessionMcpCompactListRow = ReturnType<typeof compactSessionMcpListRow>;
+export type SessionMcpCompactDetail = ReturnType<typeof compactSessionMcpDetail>;

package/dist/session-message-search.d.ts

@@ -0,0 +1,68 @@
+import { z } from "zod";
+/** Literal Unicode case-insensitive search, without trimming or normalization. */
+export declare const SessionMessageSearchRequest: z.ZodObject<{
+    query: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    groupBy: z.ZodOptional<z.ZodLiteral<"session">>;
+    archiveStatus: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        all: "all";
+        archived: "archived";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SessionMessageSearchRequest = z.infer<typeof SessionMessageSearchRequest>;
+export declare const SessionMessageSearchMatch: z.ZodObject<{
+    sessionId: z.ZodString;
+    sessionTitle: z.ZodNullable<z.ZodString>;
+    eventId: z.ZodString;
+    sequence: z.ZodNumber;
+    turnId: z.ZodNullable<z.ZodString>;
+    role: z.ZodEnum<{
+        assistant: "assistant";
+        user: "user";
+    }>;
+    messageId: z.ZodNullable<z.ZodString>;
+    messageMatchOffset: z.ZodNumber;
+    snippet: z.ZodObject<{
+        text: z.ZodString;
+        matchStart: z.ZodNumber;
+        matchEnd: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SessionMessageSearchMatch = z.infer<typeof SessionMessageSearchMatch>;
+/** A bounded scan page, not necessarily a full page of matches. Continue even
+ * after an empty page while hasMore is true. Counts describe this live traversal,
+ * not a frozen snapshot; restart to reflect concurrent changes. All non-overlapping
+ * literal occurrences in user messages and completed assistant messages.
+ * With groupBy=session, matches and both matched counts describe one first-hit
+ * representative per matching session, not full message/occurrence totals.
+ */
+export declare const SessionMessageSearchResponse: z.ZodObject<{
+    matches: z.ZodArray<z.ZodObject<{
+        sessionId: z.ZodString;
+        sessionTitle: z.ZodNullable<z.ZodString>;
+        eventId: z.ZodString;
+        sequence: z.ZodNumber;
+        turnId: z.ZodNullable<z.ZodString>;
+        role: z.ZodEnum<{
+            assistant: "assistant";
+            user: "user";
+        }>;
+        messageId: z.ZodNullable<z.ZodString>;
+        messageMatchOffset: z.ZodNumber;
+        snippet: z.ZodObject<{
+            text: z.ZodString;
+            matchStart: z.ZodNumber;
+            matchEnd: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+    hasMore: z.ZodBoolean;
+    scannedMessages: z.ZodNumber;
+    matchedMessageCount: z.ZodNumber;
+    matchedOccurrenceCount: z.ZodNumber;
+    countIsExact: z.ZodBoolean;
+}, z.core.$strip>;
+export type SessionMessageSearchResponse = z.infer<typeof SessionMessageSearchResponse>;

package/dist/session-titles.d.ts

@@ -0,0 +1,68 @@
+/** Human-authored session titles keep the existing public API ceiling. */
+export declare const SESSION_TITLE_MAX_CHARACTERS = 200;
+/**
+ * Automatic titles are intentionally much shorter than the manual rename
+ * ceiling. This is measured in grapheme clusters so emoji and combining text
+ * are never split into malformed display strings.
+ */
+export declare const AUTOMATIC_SESSION_TITLE_MAX_GRAPHEMES = 80;
+/**
+ * Safe durable title used until semantic generation succeeds. It contains no
+ * user prompt bytes, so provider failure/offline operation cannot leak a
+ * credential or leave a raw prompt prefix in navigation surfaces.
+ */
+export declare const AUTOMATIC_SESSION_TITLE_FALLBACK = "New conversation";
+export declare const PROMPT_PREVIEW_SCAN_MAX_CODE_UNITS = 4096;
+/**
+ * Whether a bounded automatic-title candidate contains a credential, URL, or
+ * opaque identifier that must stay out of navigation and other display-title
+ * surfaces. Callers handling an unbounded source must bound it before invoking
+ * this helper.
+ */
+export declare function containsSensitiveAutomaticSessionTitleValue(value: string): boolean;
+/** Bound an already-normalized automatic-title candidate without splitting graphemes. */
+export declare function boundAutomaticSessionTitle(value: string): string;
+/**
+ * Normalize a model/system-authored title before it reaches durable session
+ * metadata. Human renames intentionally do not use this path.
+ *
+ * Returns null when the candidate is empty, only boilerplate, or appears to
+ * contain a credential/opaque prompt value. Callers should retain the current
+ * title (normally {@link AUTOMATIC_SESSION_TITLE_FALLBACK}) in that case.
+ */
+export declare function normalizeAutomaticSessionTitle(value: string): string | null;
+export type SessionDisplayTitleInput = {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    titleSource?: "user" | "agent" | null | undefined;
+    initialMessage?: string | null | undefined;
+    metadata?: Readonly<Record<string, unknown>> | undefined;
+};
+export type SessionDisplayTitleOptions = {
+    /** Optional metadata fields to try before the opening-prompt preview. */
+    metadataKeys?: readonly string[] | undefined;
+};
+/**
+ * Derive a bounded, sensitive-safe preview from the opening prompt.
+ *
+ * Unsafe leading lines are skipped instead of forcing the whole session back
+ * to a generic label. This covers prompts that begin with a pasted URL or
+ * identifier followed by an ordinary natural-language request on the next
+ * line, without putting the rejected value into navigation surfaces.
+ */
+export declare function deriveAutomaticSessionTitlePreview(value: unknown): string | null;
+/**
+ * Whether the durable title still represents the automatic-title pending state.
+ * A user-authored title always wins, even when its literal value is the marker.
+ */
+export declare function sessionTitleIsPending(input: SessionDisplayTitleInput): boolean;
+/**
+ * Derive the title a human-facing client should display for a session.
+ *
+ * A semantic agent title or human rename wins. While automatic naming is still
+ * pending, clients show a short, sensitive-safe preview of the opening prompt.
+ * If no safe prompt text exists, a UUID-derived reference keeps real sessions
+ * distinguishable without exposing prompt bytes. The durable pending marker is
+ * therefore an internal lifecycle value rather than the ordinary visible name.
+ */
+export declare function deriveSessionDisplayTitle(input: SessionDisplayTitleInput, options?: SessionDisplayTitleOptions): string;

package/dist/session-titles.js

@@ -0,0 +1,25 @@
+import {
+  AUTOMATIC_SESSION_TITLE_FALLBACK,
+  AUTOMATIC_SESSION_TITLE_MAX_GRAPHEMES,
+  PROMPT_PREVIEW_SCAN_MAX_CODE_UNITS,
+  SESSION_TITLE_MAX_CHARACTERS,
+  boundAutomaticSessionTitle,
+  containsSensitiveAutomaticSessionTitleValue,
+  deriveAutomaticSessionTitlePreview,
+  deriveSessionDisplayTitle,
+  normalizeAutomaticSessionTitle,
+  sessionTitleIsPending
+} from "./chunk-2ACYHZFB.js";
+export {
+  AUTOMATIC_SESSION_TITLE_FALLBACK,
+  AUTOMATIC_SESSION_TITLE_MAX_GRAPHEMES,
+  PROMPT_PREVIEW_SCAN_MAX_CODE_UNITS,
+  SESSION_TITLE_MAX_CHARACTERS,
+  boundAutomaticSessionTitle,
+  containsSensitiveAutomaticSessionTitleValue,
+  deriveAutomaticSessionTitlePreview,
+  deriveSessionDisplayTitle,
+  normalizeAutomaticSessionTitle,
+  sessionTitleIsPending
+};
+//# sourceMappingURL=session-titles.js.map

package/dist/session-titles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/session-topology-primitives.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const SessionStatus: z.ZodEnum<{
+    cancelled: "cancelled";
+    failed: "failed";
+    idle: "idle";
+    queued: "queued";
+    recovering: "recovering";
+    requires_action: "requires_action";
+    running: "running";
+    waiting_capacity: "waiting_capacity";
+}>;
+export type SessionStatus = z.infer<typeof SessionStatus>;
+export declare const SessionGoalStatus: z.ZodEnum<{
+    active: "active";
+    completed: "completed";
+    paused: "paused";
+}>;
+export type SessionGoalStatus = z.infer<typeof SessionGoalStatus>;
+/** Physical ceiling of the PostgreSQL integer columns that persist depth policy. */
+export declare const MAX_NESTED_AGENT_DEPTH = 2147483647;
+export declare const NestedAgentDepthValue: z.ZodNumber;
+export type NestedAgentDepthValue = z.infer<typeof NestedAgentDepthValue>;

package/dist/signup-attribution.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+/**
+ * First-touch marketing parameters accepted on the web app landing URL. The
+ * browser keeps them in memory only and forwards them with a sign-up request,
+ * so nothing is written to the device before analytics consent.
+ */
+export declare const SIGNUP_ATTRIBUTION_URL_PARAMETERS: {
+    readonly utmSource: "utm_source";
+    readonly utmMedium: "utm_medium";
+    readonly utmCampaign: "utm_campaign";
+    readonly utmContent: "utm_content";
+    readonly ref: "ref";
+};
+/** Maximum retained length of one attribution value. */
+export declare const SIGNUP_ATTRIBUTION_VALUE_MAX_LENGTH = 100;
+/**
+ * Campaign labels are marketer-chosen slug tokens such as `hero-cta` or
+ * `opengeni.ai`. The closed character set has no space, `@`, `:`, `/`, `?`,
+ * `=`, or `%`, so free text, email addresses, and URL payloads are rejected
+ * before they reach any sink. The web boot capture and the session-set social
+ * start request mirror this rule; tests pin each copy to it.
+ */
+export declare const SIGNUP_ATTRIBUTION_VALUE_PATTERN: RegExp;
+export declare const SignupAttribution: z.ZodObject<{
+    utmSource: z.ZodOptional<z.ZodString>;
+    utmMedium: z.ZodOptional<z.ZodString>;
+    utmCampaign: z.ZodOptional<z.ZodString>;
+    utmContent: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SignupAttribution = z.infer<typeof SignupAttribution>;
+/** Closed acquisition channels reported by server-side sign-up metrics. */
+export declare const SIGNUP_ACQUISITION_SOURCES: readonly ["producthunt", "website", "direct", "other"];
+export type SignupAcquisitionSource = (typeof SIGNUP_ACQUISITION_SOURCES)[number];
+/**
+ * Normalize untrusted first-touch attribution to a closed channel. Missing
+ * attribution is `direct`; malformed or unrecognized attribution is `other`.
+ */
+export declare function signupAcquisitionSource(input: unknown): SignupAcquisitionSource;

package/dist/site-request-headers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/site-session-http.d.ts

@@ -0,0 +1,11 @@
+/** A Site/Codemode SDK request named a route outside the proxied surface. */
+export declare class SiteSessionPathError extends Error {
+    readonly code = "site_session_path_unsupported";
+    constructor();
+}
+/** Route browser/preview SDK requests to the host workspace. This is a URL
+ * boundary, not an endpoint or HTTP-method allowlist. Ordinary API handlers
+ * authorize every operation with the viewer or agent's existing authority. */
+export declare function siteSessionPath(path: string, workspaceId: string, _method?: string, siteId?: string): string;
+/** Preserve SDK request semantics while the host supplies identity and transport headers. */
+export declare function siteRequestHeaders(input: HeadersInit): Headers;

package/dist/site-session-http.js

@@ -0,0 +1,11 @@
+import {
+  SiteSessionPathError,
+  siteRequestHeaders,
+  siteSessionPath
+} from "./chunk-YRXAWWCU.js";
+export {
+  SiteSessionPathError,
+  siteRequestHeaders,
+  siteSessionPath
+};
+//# sourceMappingURL=site-session-http.js.map

package/dist/site-session-http.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/skill-catalog-context.d.ts

@@ -0,0 +1,7 @@
+/** Durable, model-visible catalog context. Text markers survive SDK/provider replay. */
+export declare const SKILL_CATALOG_CONTEXT_PREFIX = "<opengeni_skill_catalog>\n";
+export declare const SKILL_CATALOG_CONTEXT_SUFFIX = "\n</opengeni_skill_catalog>";
+export declare function skillCatalogContextItem(catalog: string): Record<string, unknown>;
+/** Accept the Chat Completions projection and SDK text-part normalization too. */
+export declare function readSkillCatalogContext(item: Record<string, unknown>): string | null;
+export declare function latestSkillCatalogContext(items: readonly Record<string, unknown>[]): Record<string, unknown> | undefined;

package/dist/skill-files.d.ts

@@ -0,0 +1,12 @@
+/** Shared text-folder limits for API admission, runtime imports and checkout. */
+export declare const SKILL_MAX_FILES = 1024;
+export declare const SKILL_MAX_FILE_BYTES: number;
+export declare const SKILL_MAX_TOTAL_BYTES: number;
+export declare function isSafeSkillRelativePath(path: string): boolean;
+/** Validates bytes, not extensions. Does not rewrite text or interpret metadata. */
+export declare function validateSkillTextFiles(files: readonly {
+    path: string;
+    content: string;
+}[]): {
+    totalBytes: number;
+};

package/dist/skill-metadata.d.ts

@@ -0,0 +1,9 @@
+/** The one interpretation of Skill metadata for imports, writes and migration. */
+export declare function parseSkillFrontmatter(markdown: string): {
+    name: string | null;
+    description: string | null;
+};
+export declare function readSkillMetadata(markdown: string): {
+    name: string;
+    description: string;
+};

package/dist/skill-use.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+/**
+ * `_meta` key of the content-free Skill-use fact on a model `skill_read`
+ * result. MCP `_meta` never reaches the model: it survives only into the
+ * `agent.toolCall.output` event projection, never into model history.
+ */
+export declare const SKILL_USE_META_KEY: "opengeni/skillUse";
+/** Where the Skill a read resolved to comes from. `personal` is a user-scope Skill. */
+export declare const SkillUseSource: z.ZodEnum<{
+    builtin: "builtin";
+    organization: "organization";
+    personal: "personal";
+    session: "session";
+    workspace: "workspace";
+}>;
+export type SkillUseSource = z.infer<typeof SkillUseSource>;
+/**
+ * What a `skill_read` returned: `full` is the default SKILL.md read, `files`
+ * explicit paths, `list` a path inventory, and `already_in_context` the short
+ * repeat receipt. `refused` means the read returned an error instead of Skill
+ * text; it has no result, so it appears only in metrics.
+ */
+export declare const SkillReadKind: z.ZodEnum<{
+    already_in_context: "already_in_context";
+    files: "files";
+    full: "full";
+    list: "list";
+    refused: "refused";
+}>;
+export type SkillReadKind = z.infer<typeof SkillReadKind>;
+/**
+ * Ids, digests, and counts only. Never Skill text, user text, or a Skill's
+ * title or description. `label` is reserved for a platform display label of a
+ * built-in; user-authored Skills never set it. This is the writer's closed
+ * shape: an unknown field fails the parse, so nothing else can be attached.
+ */
+export declare const SkillUse: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodEnum<{
+        builtin: "builtin";
+        organization: "organization";
+        personal: "personal";
+        session: "session";
+        workspace: "workspace";
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+    contentSha256: z.ZodOptional<z.ZodString>;
+    revisionId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        already_in_context: "already_in_context";
+        files: "files";
+        full: "full";
+        list: "list";
+    }>;
+    bytes: z.ZodNumber;
+    inIndex: z.ZodBoolean;
+    searchedThisTurn: z.ZodBoolean;
+}, z.core.$strict>;
+export type SkillUse = z.infer<typeof SkillUse>;
+/** The Skill-use fact on a tool result or its event projection, when present and valid. */
+export declare function skillUseFromToolOutput(output: unknown): SkillUse | null;