@tangle-network/agent-app 4.0.0 → 4.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/dist/agent-profiles/d1.js +1 -1
  2. package/dist/agent-profiles/index.d.ts +2 -1
  3. package/dist/agent-profiles/index.js +1 -1
  4. package/dist/chat-routes/index.js +12 -17
  5. package/dist/chat-routes/index.js.map +1 -1
  6. package/dist/chat-routes/visible-text.d.ts +7 -0
  7. package/dist/{chunk-AFMLLZWU.js → chunk-GWATTXFR.js} +3 -3
  8. package/dist/{chunk-AFMLLZWU.js.map → chunk-GWATTXFR.js.map} +1 -1
  9. package/dist/{chunk-HES3IABJ.js → chunk-JKYCXQFI.js} +2 -2
  10. package/dist/{chunk-PABZALSD.js → chunk-LBMFQLBS.js} +9 -6
  11. package/dist/{chunk-PABZALSD.js.map → chunk-LBMFQLBS.js.map} +1 -1
  12. package/dist/{chunk-5DAEU3CP.js → chunk-SJKQUTGU.js} +11 -6
  13. package/dist/chunk-SJKQUTGU.js.map +1 -0
  14. package/dist/{chunk-JSWBJBPM.js → chunk-W5YQZEE4.js} +15 -10
  15. package/dist/chunk-W5YQZEE4.js.map +1 -0
  16. package/dist/{chunk-PISTUUEZ.js → chunk-XCUT2I52.js} +25 -12
  17. package/dist/{chunk-PISTUUEZ.js.map → chunk-XCUT2I52.js.map} +1 -1
  18. package/dist/{chunk-BRQ2SC6V.js → chunk-XKVJQVOT.js} +2 -1
  19. package/dist/chunk-XKVJQVOT.js.map +1 -0
  20. package/dist/conformance/cli.js +2 -2
  21. package/dist/conformance/cli.js.map +1 -1
  22. package/dist/conformance/index.js +1 -1
  23. package/dist/conformance/run.d.ts +3 -2
  24. package/dist/preset-cloudflare/index.js +2 -2
  25. package/dist/public-consultation/index.d.ts +1 -1
  26. package/dist/public-consultation/index.js +5 -3
  27. package/dist/public-consultation/index.js.map +1 -1
  28. package/dist/runtime/index.js +4 -2
  29. package/dist/runtime/index.js.map +1 -1
  30. package/dist/runtime/router-turn.d.ts +15 -0
  31. package/dist/runtime/router-turn.js +3 -1
  32. package/package.json +1 -1
  33. package/dist/chunk-5DAEU3CP.js.map +0 -1
  34. package/dist/chunk-BRQ2SC6V.js.map +0 -1
  35. package/dist/chunk-JSWBJBPM.js.map +0 -1
  36. /package/dist/{chunk-HES3IABJ.js.map → chunk-JKYCXQFI.js.map} +0 -0
@@ -670,6 +670,7 @@ function profileTools(context) {
670
670
  return [{
671
671
  name: "profile.read",
672
672
  description: "Read the active agent profile text and revision. Saved text applies on the next message.",
673
+ effect: "lookup",
673
674
  inputSchema: z.toJSONSchema(z.object({}).strict(), { io: "input" }),
674
675
  async run(args) {
675
676
  z.object({}).strict().parse(args);
@@ -825,4 +826,4 @@ export {
825
826
  PROFILE_MEMORY_PREFIX,
826
827
  profileTools
827
828
  };
828
- //# sourceMappingURL=chunk-BRQ2SC6V.js.map
829
+ //# sourceMappingURL=chunk-XKVJQVOT.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/agent-profiles/index.ts","../src/agent-profiles/self-management.ts","../src/agent-profiles/release.ts"],"sourcesContent":["/** Chat-owned profile revisions and member/channel bindings. Execution stays in the substrate. */\nimport {\n canonicalAgentProfileDigest,\n diffAgentProfiles,\n snapshotAgentProfile,\n sha256Utf8,\n type AgentProfile,\n type AgentProfileDiff,\n} from '@tangle-network/agent-interface'\nimport { z } from 'zod'\nimport { normalizeProfileName, parseProfileSwitch } from './switch'\nexport { normalizeProfileName, parseProfileSwitch }\nimport type { McpToolDefinition } from '../tools'\nimport type { RouterTurnTool } from '../runtime/router-turn'\n\nexport type ProfileAuthorKind = 'person' | 'agent' | 'optimizer'\nexport type ProfileRevisionState = 'active' | 'candidate' | 'pending-consent'\n\n/** The decision table used by every write path; products may narrow access, never widen it. */\nconst PROFILE_CHANGE_POLICY = {\n textEdit: { admission: 'automatic', conversation: 'same', destructive: false },\n sameAuthoritySwitch: { admission: 'prepare-then-flip', conversation: 'same', destructive: false },\n differentAuthoritySwitch: { admission: 'prepare-then-flip', conversation: 'same', destructive: false },\n authorityEdit: { admission: 'editor-consent', conversation: 'same', destructive: false },\n optimizerRevision: { admission: 'eval-promotion', conversation: 'same', destructive: false },\n destructiveAction: { admission: 'reaper-only', conversation: 'none', destructive: true },\n} as const\n\nexport interface ProfileRevision {\n id: string\n workspaceId: string\n profileId: string\n parentId: string | null\n profile: AgentProfile\n knowledgeText: string\n author: { kind: ProfileAuthorKind; id: string }\n reason: string\n /** `null` means an older stored revision did not record the knowledge delta. */\n knowledgeTextChanged?: boolean | null\n diff: AgentProfileDiff[]\n authorityDigest: string\n /** ADC hash of the public profile plan, without per-turn product attachments. */\n planDigest: string\n state: ProfileRevisionState\n createdAt: number\n}\n\nexport interface ProfileBindingKey {\n workspaceId: string\n memberId: string\n /** `chat`, or a product-scoped phone line and sender key. */\n channel: string\n}\n\nexport interface ProfileBinding extends ProfileBindingKey {\n profileId: string\n pinnedRevisionId: string | null\n authorityDigest: string\n planDigest: string\n version: number\n}\n\nexport interface ProfileTurnPin {\n workspaceId: string\n memberId: string\n channel: string\n messageId: string\n inputHash: string\n profileId: string\n revisionId: string\n authorityDigest: string\n /** Effective ADC plan selected by the executor, including allowed turn attachments. */\n planDigest: string\n}\n\n/** Remove events name only adds they observed; a concurrent add survives. */\nexport interface ProfileKnowledgeEvent {\n id: string\n workspaceId: string\n profileId: string\n documentId: string\n kind: 'add' | 'remove'\n content: string | null\n observedAddIds: string[]\n createdAt: number\n}\n\n\nexport interface ProfileSwitchReceipt {\n key: ProfileBindingKey\n messageId: string\n inputHash: string\n /** Visible conversation that should render this switch marker on reload. */\n conversationId?: string | null\n createdAt?: number\n profileId: string | null\n revisionId: string | null\n /** A rollback binds the previous immutable revision, not the current head. */\n pinnedRevisionId: string | null\n authorityDigest: string | null\n planDigest: string | null\n outcome: 'switched' | 'refused'\n message: string\n /** Workspace resource collisions retain the original and place the profile copy beside it. */\n conflicts: string[]\n}\n\nexport interface ProfileRevisionStore {\n getActiveRevision(workspaceId: string, profileId: string): Promise<ProfileRevision | null>\n getRevision(workspaceId: string, profileId: string, revisionId: string): Promise<ProfileRevision | null>\n /** Append the immutable row and optionally an activation event in one guarded transaction. */\n appendRevision(revision: ProfileRevision, expectedActiveId: string | null, activate: boolean): Promise<boolean>\n /** Promotion appends an activation event; the historical revision remains immutable. */\n promoteRevision(workspaceId: string, profileId: string, revisionId: string, expectedActiveId: string | null): Promise<boolean>\n getBinding(key: ProfileBindingKey): Promise<ProfileBinding | null>\n getSwitchReceipt(key: ProfileBindingKey, messageId: string, inputHash: string): Promise<ProfileSwitchReceipt | null>\n /** Receipt and binding event append atomically; a refusal leaves the binding untouched. */\n recordSwitch(receipt: ProfileSwitchReceipt, expectedVersion: number): Promise<ProfileSwitchReceipt>\n /** Persist one immutable pin under a message id; retries must return the same pin. */\n pinTurn(pin: ProfileTurnPin, expectedBindingVersion: number, options?: { priorChecked?: boolean }): Promise<ProfileTurnPin>\n getTurnPin(key: ProfileBindingKey, messageId: string, inputHash: string): Promise<ProfileTurnPin | null>\n listKnowledgeEvents(workspaceId: string, profileId: string): Promise<ProfileKnowledgeEvent[]>\n appendKnowledgeEvent(event: ProfileKnowledgeEvent): Promise<void>\n /** A revision and its ancestors, newest first, in one read; it ends early at a missing ancestor.\n * Without it, `followProductRelease` reads the history one `getRevision` at a time. */\n readPromptHistory?(workspaceId: string, profileId: string, revisionId: string): Promise<ProfilePromptHistoryEntry[]>\n}\n\n/** One revision of a profile's history, reduced to what decides whether the newest one's system prompt is product\n * text. Prompts are compared where they are stored, so the history carries no prompt text. */\nexport interface ProfilePromptHistoryEntry {\n id: string\n parentId: string | null\n author: ProfileRevision['author']\n /** Its system prompt equals the newest entry's. */\n sameAsNewest: boolean\n /** Its system prompt equals its parent's; `null` when it has no parent row. */\n sameAsParent: boolean | null\n}\n\nexport class ProfileConflictError extends Error {\n constructor(message: string, readonly code?: 'profile_changed') {\n super(message)\n this.name = 'ProfileConflictError'\n }\n}\n\nexport class ProfileAccessError extends Error {\n constructor(message: string) {\n super(message)\n this.name = 'ProfileAccessError'\n }\n}\n\n/** Keep the existing diff column readable while adding the separate knowledge text axis. */\nexport function parseProfileRevisionDiff(value: string): {\n diff: AgentProfileDiff[]; knowledgeTextChanged: boolean | null\n} {\n const parsed: unknown = JSON.parse(value)\n if (Array.isArray(parsed)) return { diff: parsed as AgentProfileDiff[], knowledgeTextChanged: null }\n if (!parsed || typeof parsed !== 'object' || !('profile' in parsed) ||\n !Array.isArray(parsed.profile) || !('knowledgeTextChanged' in parsed) ||\n (parsed.knowledgeTextChanged !== null && typeof parsed.knowledgeTextChanged !== 'boolean')) {\n throw new TypeError('Stored profile revision diff is invalid')\n }\n return { diff: parsed.profile as AgentProfileDiff[],\n knowledgeTextChanged: parsed.knowledgeTextChanged }\n}\n\nexport function serializeProfileRevisionDiff(revision: Pick<ProfileRevision, 'diff' | 'knowledgeTextChanged'>): string {\n return JSON.stringify({ profile: revision.diff, knowledgeTextChanged: revision.knowledgeTextChanged ?? null })\n}\n\n/** Remove exactly the declared text axes. Unknown future fields remain authority. */\nexport function profileAuthority(profile: AgentProfile): AgentProfile {\n const { name: _name, description: _description, prompt, ...authority } = profile\n const { systemPrompt: _systemPrompt, instructions: _instructions, ...promptAuthority } = prompt ?? {}\n return { ...authority, ...(Object.keys(promptAuthority).length ? { prompt: promptAuthority } : {}) }\n}\n\nexport function profileAuthorityDigest(profile: AgentProfile): string {\n return canonicalAgentProfileDigest(profileAuthority(snapshotAgentProfile(profile)))\n}\n\n/** The per-turn text overlay is validated without admitting tools, model, MCP or resources. */\nexport function bindProfileText(consentedBaseline: AgentProfile, selected: AgentProfile): AgentProfile {\n if (profileAuthorityDigest(consentedBaseline) !== profileAuthorityDigest(selected)) {\n throw new ProfileAccessError('Profile authority differs; prepare its managed plan before the next turn')\n }\n // Profiles are digested as RFC 8785 JSON, which has no `undefined`: an\n // absent selected field removes the baseline's value instead of storing it.\n const result: AgentProfile = { ...consentedBaseline, name: selected.name }\n if (selected.description === undefined) delete result.description\n else result.description = selected.description\n const prompt: NonNullable<AgentProfile['prompt']> = { ...consentedBaseline.prompt }\n const { systemPrompt, instructions } = selected.prompt ?? {}\n if (systemPrompt === undefined) delete prompt.systemPrompt\n else prompt.systemPrompt = systemPrompt\n if (instructions === undefined) delete prompt.instructions\n else prompt.instructions = instructions\n if (Object.values(prompt).some(value => value !== undefined)) result.prompt = prompt\n else delete result.prompt\n return snapshotAgentProfile(result)\n}\n\nexport interface ProposeRevisionInput {\n store: ProfileRevisionStore\n workspaceId: string\n profileId: string\n expectedRevisionId: string | null\n profile: AgentProfile\n knowledgeText: string\n /** The exact ADC `hashWorkspacePlan` for this authored snapshot. */\n planDigest: string\n author: ProfileRevision['author']\n /** Trusted role from the authenticated session, never model arguments. */\n actorRole: 'owner' | 'manager' | 'member' | 'viewer'\n reason: string\n id?: string\n now?: number\n}\n\n/** All authors use one immutable write path. Optimizer and authority edits cannot self-activate. */\nexport async function proposeRevision(input: ProposeRevisionInput): Promise<ProfileRevision> {\n if (input.author.kind !== 'optimizer' && input.actorRole !== 'owner' && input.actorRole !== 'manager') {\n throw new ProfileAccessError('Only an owner or manager can change a profile')\n }\n if (!input.workspaceId || !input.profileId || !input.author.id || !input.reason.trim() ||\n !/^sha256:[a-f0-9]{64}$/.test(input.planDigest)) {\n throw new TypeError('A profile revision needs workspace, profile, author, reason and plan digest')\n }\n const previous = await input.store.getActiveRevision(input.workspaceId, input.profileId)\n if ((previous?.id ?? null) !== input.expectedRevisionId) {\n throw new ProfileConflictError('The profile changed; read its latest revision before saving')\n }\n const profile = snapshotAgentProfile(input.profile)\n const diff = previous ? diffAgentProfiles(previous.profile, profile) : []\n const authorityDigest = profileAuthorityDigest(profile)\n const authorityChanged = !!previous && previous.authorityDigest !== authorityDigest\n const admission = input.author.kind === 'optimizer'\n ? PROFILE_CHANGE_POLICY.optimizerRevision.admission\n : authorityChanged\n ? PROFILE_CHANGE_POLICY.authorityEdit.admission\n : PROFILE_CHANGE_POLICY.textEdit.admission\n const state: ProfileRevisionState = admission === 'eval-promotion' ? 'candidate'\n : admission === 'editor-consent' ? 'pending-consent' : 'active'\n const revision: ProfileRevision = {\n id: input.id ?? crypto.randomUUID(), workspaceId: input.workspaceId, profileId: input.profileId,\n parentId: previous?.id ?? null, profile, knowledgeText: input.knowledgeText,\n author: input.author, reason: input.reason.trim(), diff,\n knowledgeTextChanged: previous ? previous.knowledgeText !== input.knowledgeText : input.knowledgeText.length > 0,\n authorityDigest,\n planDigest: input.planDigest, state, createdAt: input.now ?? Date.now(),\n }\n if (!await input.store.appendRevision(revision, input.expectedRevisionId, state === 'active')) {\n throw new ProfileConflictError('The profile changed while saving')\n }\n return revision\n}\n\nexport interface CreateTextProfileInput {\n store: ProfileRevisionStore\n workspaceId: string\n /** An active profile whose authority the new profile inherits exactly. */\n baselineProfileId: string\n /** Include builtins and user profiles from the authenticated workspace catalog. */\n existingProfiles: readonly { name: string }[]\n name: string\n instructions: string\n authorId: string\n actorRole: 'owner' | 'manager' | 'member' | 'viewer'\n /** Product computes ADC's hashWorkspacePlan for the complete authored snapshot. */\n planDigest: (profile: AgentProfile) => string | Promise<string>\n /** The profile a turn runs for a stored revision (usually {@link followProductRelease}). With it, a new profile\n * whose baseline runs the release's system prompt stores none, so it runs the product's current one at every\n * release, not a stored copy; a system prompt a person wrote on the baseline is copied. A read path that shows the\n * prompt must read it through the same function. */\n followRelease?: (revision: ProfileRevision) => Promise<AgentProfile>\n now?: number\n}\n\n/** Create a distinct text persona without granting new model, tool, MCP or secret authority. */\nexport async function createTextProfile(input: CreateTextProfileInput): Promise<ProfileRevision> {\n if (input.actorRole !== 'owner' && input.actorRole !== 'manager') {\n throw new ProfileAccessError('Only an owner or manager can create a profile')\n }\n const name = input.name.trim().replace(/\\s+/g, ' ')\n const normalizedName = normalizeProfileName(name)\n if (!normalizedName) throw new TypeError('A profile needs a name')\n if (input.existingProfiles.some(profile => normalizeProfileName(profile.name) === normalizedName)) {\n throw new ProfileConflictError('A profile with that name already exists')\n }\n const baseline = await input.store.getActiveRevision(input.workspaceId, input.baselineProfileId)\n if (!baseline) throw new ProfileConflictError('The baseline profile is not active')\n // Equal names map to one id, so two concurrent creates cannot create an\n // ambiguous text command even when both read the catalog before either writes.\n const profileId = `custom-${sha256Utf8(`${input.workspaceId}\\0${normalizedName}`).slice(7, 39)}`\n const addedInstruction = input.instructions.trim()\n const text = input.followRelease ? await input.followRelease(baseline) : baseline.profile\n // Where the baseline runs the release's system prompt, the new profile stores none: an absent one runs the\n // release's at every turn (followProductRelease), where a copy of today's would stop following at the next release.\n // A prompt a person wrote on the baseline is copied. The release's is what the baseline runs with no prompt of its own.\n const { systemPrompt: followed, ...withoutPrompt } = text.prompt ?? {}\n const release = input.followRelease\n && (await input.followRelease({ ...baseline, profile: { ...baseline.profile, prompt: withoutPrompt } })).prompt?.systemPrompt\n const prompt = input.followRelease && followed === release ? withoutPrompt : text.prompt\n const profile = bindProfileText(baseline.profile, {\n ...text, name,\n prompt: {\n ...prompt,\n instructions: [...(text.prompt?.instructions ?? []),\n ...(addedInstruction ? [addedInstruction] : [])],\n },\n })\n return proposeRevision({\n store: input.store, workspaceId: input.workspaceId, profileId,\n expectedRevisionId: null, profile, knowledgeText: '',\n planDigest: await input.planDigest(profile),\n author: { kind: 'person', id: input.authorId }, actorRole: input.actorRole,\n reason: 'Created a text profile from an approved baseline', now: input.now,\n })\n}\n\nexport async function promoteRevision(input: {\n store: ProfileRevisionStore\n workspaceId: string\n profileId: string\n revisionId: string\n actorRole: 'owner' | 'manager' | 'member' | 'viewer'\n /** Verified by the product's consent route; required when authority changes. */\n verifyConsent?: (revision: ProfileRevision) => Promise<boolean>\n}): Promise<ProfileRevision> {\n if (input.actorRole !== 'owner' && input.actorRole !== 'manager') {\n throw new ProfileAccessError('Only an owner or manager can promote a profile')\n }\n const [revision, head] = await Promise.all([\n input.store.getRevision(input.workspaceId, input.profileId, input.revisionId),\n input.store.getActiveRevision(input.workspaceId, input.profileId),\n ])\n if (!revision || revision.parentId !== (head?.id ?? null)) throw new ProfileConflictError('Profile parent changed')\n if (revision.authorityDigest !== head?.authorityDigest &&\n (input.actorRole !== 'owner' || !input.verifyConsent || !await input.verifyConsent(revision))) {\n throw new ProfileAccessError('Authority changes require owner consent')\n }\n if (!await input.store.promoteRevision(input.workspaceId, input.profileId, revision.id, head?.id ?? null)) {\n throw new ProfileConflictError('The profile changed while promoting')\n }\n return revision\n}\n\n/** A source identity joins the command hash without entering the receipt row. */\nfunction profileSwitchInputHashFromContentHash(contentHash: string,\n identityContext?: string): string {\n return identityContext === undefined ? contentHash\n : sha256Utf8(JSON.stringify([identityContext, contentHash]))\n}\n\nexport function profileSwitchInputHash(content: string, identityContext?: string): string {\n return profileSwitchInputHashFromContentHash(sha256Utf8(content), identityContext)\n}\n\nexport interface SwitchableProfile {\n id: string\n name: string\n status: 'active' | 'draft' | 'paused'\n}\n\nexport interface SwitchProfileInput {\n store: ProfileRevisionStore\n key: ProfileBindingKey\n messageId: string\n content: string\n /** Trusted source identity, such as a phone sender; replay must preserve it. */\n identityContext?: string\n conversationId?: string\n choice: { name: string } | { profileId: string }\n profiles: readonly SwitchableProfile[]\n /** Product's role/phone allowlist decision for the authenticated member. */\n canSelect: (profileId: string) => Promise<boolean>\n /** Stage a complete managed plan for the same conversation; never mutate live workspace files. */\n prepareAuthority: (revision: ProfileRevision, key: ProfileBindingKey) => Promise<{\n planDigest: string; healthy: true; conflicts: string[]\n }>\n /** Receives the reason preparation failed; the person sees only a generic refusal.\n * Defaults to one structured `console.error` line so the reason reaches the host's logs. */\n onPrepareFailure?: (error: unknown, profileId: string) => void\n}\n\n/** The picker and deterministic text command converge here. Models cannot call it. */\nfunction logPrepareFailure(error: unknown, profileId: string): void {\n console.error(JSON.stringify({ event: 'profile-switch-prepare-failed', profileId,\n error: error instanceof Error ? `${error.name}: ${error.message}` : String(error) }))\n}\n\nexport async function switchProfile(input: SwitchProfileInput): Promise<ProfileSwitchReceipt> {\n const inputHash = profileSwitchInputHash(input.content, input.identityContext)\n const previousReceipt = await input.store.getSwitchReceipt(input.key, input.messageId, inputHash)\n if (previousReceipt) return previousReceipt\n const binding = await input.store.getBinding(input.key)\n const choice = input.choice\n const matches = 'name' in choice\n ? input.profiles.filter(profile => normalizeProfileName(profile.name) === normalizeProfileName(choice.name))\n : input.profiles.filter(profile => profile.id === choice.profileId)\n const target = matches.length === 1 ? matches[0] : undefined\n let revision: ProfileRevision | null = null\n if (target?.status === 'active' && await input.canSelect(target.id)) {\n revision = await input.store.getActiveRevision(input.key.workspaceId, target.id)\n if (revision && 'name' in choice &&\n normalizeProfileName(revision.profile.name ?? '') !== normalizeProfileName(choice.name)) {\n revision = null\n }\n }\n let outcome: ProfileSwitchReceipt['outcome'] = 'refused'\n let message = matches.length > 1 ? 'That profile name is ambiguous.'\n : target?.status !== 'active' && target ? `${target.name} is not active.`\n : 'That profile is not available for this member.'\n let planDigest: string | null = null\n let conflicts: string[] = []\n if (revision && target) {\n try {\n const prepared = await input.prepareAuthority(revision, input.key)\n if (!prepared.healthy || prepared.planDigest !== revision.planDigest) {\n throw new ProfileConflictError('The managed plan was not prepared for this revision')\n }\n planDigest = prepared.planDigest\n conflicts = prepared.conflicts\n } catch (error) {\n revision = null\n message = `Could not prepare ${target.name}; your current agent is unchanged.`\n ;(input.onPrepareFailure ?? logPrepareFailure)(error, target.id)\n }\n if (revision && planDigest) {\n outcome = 'switched'\n message = `Now talking to ${target.name}`\n }\n }\n return input.store.recordSwitch({ key: input.key, messageId: input.messageId, inputHash,\n conversationId: input.conversationId,\n profileId: revision?.profileId ?? null, revisionId: revision?.id ?? null,\n pinnedRevisionId: null, authorityDigest: revision?.authorityDigest ?? null,\n planDigest, outcome, message, conflicts }, binding?.version ?? 0)\n}\n\n/** Call before dispatching a chat message; a recognized command is never sent to the model. */\nexport async function handleProfileSwitchText(\n input: Omit<SwitchProfileInput, 'choice'>,\n): Promise<ProfileSwitchReceipt | null> {\n const parsed = parseProfileSwitch(input.content)\n if (!parsed) return null\n if ('name' in parsed) return switchProfile({ ...input, choice: parsed })\n const inputHash = profileSwitchInputHash(input.content, input.identityContext)\n const previous = await input.store.getSwitchReceipt(input.key, input.messageId, inputHash)\n if (previous) return previous\n const binding = await input.store.getBinding(input.key)\n return input.store.recordSwitch({ key: input.key, messageId: input.messageId, inputHash,\n conversationId: input.conversationId,\n profileId: null, revisionId: null, pinnedRevisionId: null, outcome: 'refused',\n authorityDigest: null, planDigest: null, conflicts: [],\n message: 'Send only “Switch to [agent name]” to change agents.' },\n binding?.version ?? 0)\n}\n\n/**\n * An opaque token for what `readProfileAdmission` read for one message. It carries no data: the values\n * live in this module, cloned when read, so a caller can neither build a token nor change what it stands\n * for. `admitProfileTurn` accepts each token once. The active-revision pointer is never part of it;\n * admission reads that live.\n */\nexport interface ProfileAdmissionRead { readonly [admissionReadBrand]: true }\ndeclare const admissionReadBrand: unique symbol\n\n/** The values a token stands for, as the caller may inspect them. */\nexport interface ProfileAdmissionValues {\n key: ProfileBindingKey\n messageId: string\n inputHash: string\n /** The message's existing pin, when it was already admitted. */\n prior: ProfileTurnPin | null\n binding: ProfileBinding | null\n /** The pinned revision by id (immutable), when the binding pins one. */\n pinnedRevision: ProfileRevision | null\n}\nconst admissionReads = new WeakMap<ProfileAdmissionRead, ProfileAdmissionValues>()\n/** Tokens already presented, so a second use is told apart from one this module never issued. */\nconst spentAdmissionReads = new WeakSet<ProfileAdmissionRead>()\n\n/**\n * Read what admitting a message needs: its prior pin and the binding together, then a pinned revision.\n * Read it where the caller holds its conversation lock (after any switch it records), check the values\n * with `profileAdmissionValues`, and pass the token to `admitProfileTurn`, which then skips re-reading\n * the pin and binding. The pin is still written as a compare-and-set on the binding version, so a\n * binding that moved after this read is refused.\n */\nexport async function readProfileAdmission(store: ProfileRevisionStore, key: ProfileBindingKey,\n messageId: string, content: string): Promise<ProfileAdmissionRead> {\n const inputHash = sha256Utf8(content)\n const [prior, binding] = await Promise.all([store.getTurnPin(key, messageId, inputHash), store.getBinding(key)])\n const pinnedRevision = !prior && binding?.pinnedRevisionId\n ? await store.getRevision(key.workspaceId, binding.profileId, binding.pinnedRevisionId) : null\n const read = Object.freeze(Object.create(null)) as ProfileAdmissionRead\n admissionReads.set(read, structuredClone({ key: { workspaceId: key.workspaceId, memberId: key.memberId, channel: key.channel },\n messageId, inputHash, prior, binding, pinnedRevision }))\n return read\n}\n\n/** A deep copy of what a token stands for; changing the copy changes nothing the token admits. */\nexport function profileAdmissionValues(read: ProfileAdmissionRead): ProfileAdmissionValues {\n const values = admissionReads.get(read)\n if (!values) throw new ProfileAccessError('Unknown or used profile admission read')\n return structuredClone(values)\n}\n\nexport async function admitProfileTurn(input: {\n store: ProfileRevisionStore\n key: ProfileBindingKey\n messageId: string\n content: string\n /** The revision whose prompt this request already dispatched; a different pin is refused before use or write. */\n expectedRevisionId?: string\n /** Effective ADC plan digest selected by the executor for this revision and turn. */\n observedManagedPlanDigest: string\n /** Required if trusted per-turn attachments change the public profile plan. */\n verifyEffectivePlan?: (revision: ProfileRevision, effectivePlanDigest: string,\n key: ProfileBindingKey) => Promise<boolean>\n /** A token from `readProfileAdmission` for this message; its pin and binding are not read again.\n * Each token admits once: after a failed admit, read again before retrying. */\n read?: ProfileAdmissionRead\n}): Promise<ProfileTurnPin> {\n const inputHash = sha256Utf8(input.content)\n // A token is spent when presented, so it admits at most one turn even if this call fails;\n // a retry reads again with `readProfileAdmission`.\n const read = input.read ? admissionReads.get(input.read) : undefined\n if (input.read && !read && spentAdmissionReads.has(input.read)) {\n throw new ProfileConflictError('The admission read was already used; read again')\n }\n if (input.read) { admissionReads.delete(input.read); spentAdmissionReads.add(input.read) }\n if (input.read && (!read || read.messageId !== input.messageId || read.inputHash !== inputHash ||\n read.key.workspaceId !== input.key.workspaceId || read.key.memberId !== input.key.memberId ||\n read.key.channel !== input.key.channel)) {\n throw new ProfileAccessError('The admission read does not belong to this message')\n }\n const assertExpectedRevision = (revisionId: string) => {\n if (input.expectedRevisionId !== undefined && input.expectedRevisionId !== revisionId) {\n throw new ProfileConflictError('The agent profile changed while this turn started. Send the message again.', 'profile_changed')\n }\n }\n const prior = read ? read.prior : await input.store.getTurnPin(input.key, input.messageId, inputHash)\n if (prior) { assertExpectedRevision(prior.revisionId); return prior }\n const binding = read ? read.binding : await input.store.getBinding(input.key)\n if (!binding) throw new ProfileAccessError('Choose a profile before sending a message')\n // The active pointer can move without the binding version changing, so it is always read live.\n const revision = binding.pinnedRevisionId\n ? read?.pinnedRevision ?? await input.store.getRevision(input.key.workspaceId, binding.profileId, binding.pinnedRevisionId)\n : await input.store.getActiveRevision(input.key.workspaceId, binding.profileId)\n if (!revision) throw new ProfileConflictError('The bound profile revision is unavailable')\n assertExpectedRevision(revision.id)\n if (revision.authorityDigest !== binding.authorityDigest ||\n !/^sha256:[a-f0-9]{64}$/.test(input.observedManagedPlanDigest)) {\n throw new ProfileAccessError('The selected managed plan is not active for this turn')\n }\n const planMatches = revision.planDigest === input.observedManagedPlanDigest ||\n (input.verifyEffectivePlan !== undefined &&\n await input.verifyEffectivePlan(revision, input.observedManagedPlanDigest, input.key))\n if (!planMatches) {\n throw new ProfileAccessError('The selected managed plan is not active for this turn')\n }\n return input.store.pinTurn({ ...input.key, messageId: input.messageId, inputHash,\n profileId: revision.profileId, revisionId: revision.id,\n authorityDigest: revision.authorityDigest, planDigest: input.observedManagedPlanDigest }, binding.version,\n // The prior pin was read above (or with the admission read), so the store need not read it again.\n { priorChecked: true })\n}\n\nconst KNOWLEDGE_TEXT_MAX = 32000\nconst textChangeSchema = z.object({\n name: z.string().trim().min(1).max(160).optional(),\n description: z.string().max(2000).nullable().optional(),\n systemPrompt: z.string().max(32000).nullable().optional(),\n instructions: z.array(z.string().max(32000)).max(40).optional(),\n knowledgeText: z.string().max(KNOWLEDGE_TEXT_MAX).optional(),\n}).strict().refine(changes => Object.keys(changes).length > 0)\nconst updateToolSchema = z.object({ expectedRevisionId: z.string().min(1), changes: textChangeSchema }).strict()\nconst rememberToolSchema = z.object({ fact: z.string().trim().min(1).max(1000) }).strict()\n\nfunction profileTextChange(revision: ProfileRevision, changes: z.infer<typeof textChangeSchema>): {\n profile: AgentProfile; knowledgeText: string\n} {\n const profile = structuredClone(revision.profile)\n if (changes.name !== undefined) profile.name = changes.name\n if (changes.description !== undefined) profile.description = changes.description ?? undefined\n if (changes.systemPrompt !== undefined || changes.instructions !== undefined) {\n profile.prompt = { ...profile.prompt,\n ...(changes.systemPrompt !== undefined ? { systemPrompt: changes.systemPrompt ?? undefined } : {}),\n ...(changes.instructions !== undefined ? { instructions: changes.instructions } : {}) }\n }\n return { profile: snapshotAgentProfile(profile), knowledgeText: changes.knowledgeText ?? revision.knowledgeText }\n}\n\nexport interface ProfileToolTurn {\n workspaceId: string; profileId: string; revisionId: string\n memberId: string; role: 'owner' | 'manager' | 'member' | 'viewer'\n}\n\nexport interface ProfileToolContext<TTurn extends ProfileToolTurn = ProfileToolTurn> {\n /** Resolve the running turn from the trusted server session; never from tool arguments. */\n activeTurn(): Promise<TTurn>\n /** Product computes the plan with ADC, returning `hashWorkspacePlan(plan)`. */\n planDigest(profile: AgentProfile, knowledgeText: string): Promise<string>\n store: ProfileRevisionStore\n /** Return a store whose revision append atomically rechecks product turn authority. */\n storeForTurn?(turn: TTurn): ProfileRevisionStore\n /**\n * When set, `profile.remember` writes to this workspace memory store instead\n * of appending a profile revision, so remembered facts never change the\n * hashed profile (or anything that pins its version, such as a phone line).\n * Structurally matches agent-runtime's `WorkspaceStore`.\n */\n memory?: ProfileMemoryStore\n /**\n * The profile a turn runs for a stored revision (usually {@link followProductRelease}). `profile.read` shows this\n * text, and a `profile.update` that hands back its system prompt unchanged keeps the stored one, so an agent's\n * edit never stores a release's prompt as its own and the profile keeps following releases.\n */\n followRelease?: (revision: ProfileRevision) => Promise<AgentProfile>\n}\n\n/** The subset of agent-runtime's `WorkspaceStore` that `profile.remember` uses. */\nexport interface ProfileMemoryStore {\n list(workspaceId: string, prefix: string): Promise<Array<{ id: string; content?: string }>>\n put(input: { workspaceId: string; path: string; kind: 'fact'; ifRevision: null; actor: string;\n content: string; id?: string }): Promise<{ id: string; revision: number }>\n}\n\n/** Workspace-shared memories live under this prefix in the workspace store. */\nexport const PROFILE_MEMORY_PREFIX = '/memories/workspace/'\n\n/** Shared self-edit tools; only the authenticated active turn can name the profile. */\nexport function profileTools<TTurn extends ProfileToolTurn>(\n context: ProfileToolContext<TTurn>): Array<McpToolDefinition<Record<string, never>> & Pick<RouterTurnTool, 'effect'>> {\n return [{\n name: 'profile.read',\n description: 'Read the active agent profile text and revision. Saved text applies on the next message.',\n effect: 'lookup',\n inputSchema: z.toJSONSchema(z.object({}).strict(), { io: 'input' }) as Record<string, unknown>,\n async run(args) {\n z.object({}).strict().parse(args)\n const turn = await context.activeTurn()\n if (turn.role !== 'owner' && turn.role !== 'manager') throw new ProfileAccessError('Profile management is required')\n const revision = await context.store.getActiveRevision(turn.workspaceId, turn.profileId)\n if (!revision) throw new ProfileConflictError('Profile revision is unavailable')\n const shown = context.followRelease ? await context.followRelease(revision) : revision.profile\n return { profileId: turn.profileId, revisionId: revision.id, currentTurnRevisionId: turn.revisionId,\n name: shown.name, description: shown.description ?? null,\n systemPrompt: shown.prompt?.systemPrompt ?? null,\n instructions: shown.prompt?.instructions ?? [], knowledgeText: revision.knowledgeText }\n },\n }, {\n name: 'profile.update',\n description: 'Save a requested owner or manager text change with the revision from profile.read. Applies on the next message.',\n inputSchema: z.toJSONSchema(updateToolSchema, { io: 'input' }) as Record<string, unknown>,\n async run(args) {\n const { expectedRevisionId, changes } = updateToolSchema.parse(args)\n const turn = await context.activeTurn()\n if (turn.role !== 'owner' && turn.role !== 'manager') throw new ProfileAccessError('Profile management is required')\n const current = await context.store.getActiveRevision(turn.workspaceId, turn.profileId)\n if (!current || current.id !== expectedRevisionId) throw new ProfileConflictError('The profile changed; read it again')\n // The prompt profile.read showed, handed back unchanged, is not the agent's text: the stored one stays.\n const shownPrompt = context.followRelease ? (await context.followRelease(current)).prompt?.systemPrompt : undefined\n const { systemPrompt: _shown, ...withoutPrompt } = changes\n const unchangedPrompt = shownPrompt !== undefined && changes.systemPrompt === shownPrompt\n const next = profileTextChange(current, unchangedPrompt ? withoutPrompt : changes)\n const revision = await proposeRevision({ store: context.storeForTurn?.(turn) ?? context.store,\n workspaceId: turn.workspaceId,\n profileId: turn.profileId, expectedRevisionId, ...next,\n planDigest: await context.planDigest(next.profile, next.knowledgeText),\n author: { kind: 'agent', id: turn.memberId }, actorRole: turn.role,\n reason: 'Owner or manager requested a text change during chat' })\n return { profileId: turn.profileId, revisionId: revision.id, state: revision.state,\n canonicalSaved: revision.state === 'active', appliesTo: 'next_message', currentTurn: 'unchanged' }\n },\n }, {\n name: 'profile.remember',\n description: 'Save one durable fact or standing instruction an owner or manager tells you to keep '\n + '(\"remember\", \"note that\", \"from now on\", \"always\", \"never\"). Appends it as one line of the agent\\'s '\n + 'knowledge, which every later conversation reads. Applies on the next message.',\n inputSchema: z.toJSONSchema(rememberToolSchema, { io: 'input' }) as Record<string, unknown>,\n async run(args) {\n const { fact } = rememberToolSchema.parse(args)\n const turn = await context.activeTurn()\n if (turn.role !== 'owner' && turn.role !== 'manager') throw new ProfileAccessError('Profile management is required')\n if (context.memory) {\n const text = fact.replace(/\\s+/g, ' ')\n const known = (await context.memory.list(turn.workspaceId, PROFILE_MEMORY_PREFIX))\n .find(entry => entry.content?.trim() === text)\n if (known) return { memoryId: known.id, saved: true, alreadyKnown: true, line: `- ${text}`, appliesTo: 'next_message' }\n const id = crypto.randomUUID()\n const saved = await context.memory.put({ workspaceId: turn.workspaceId, path: `${PROFILE_MEMORY_PREFIX}${id}`,\n kind: 'fact', ifRevision: null, actor: turn.memberId, content: text, id })\n return { memoryId: saved.id, saved: true, alreadyKnown: false, line: `- ${text}`, appliesTo: 'next_message' }\n }\n const line = `- ${fact.replace(/\\s+/g, ' ')}`\n // One retry covers a concurrent save between the read and the append; the\n // revision chain keeps every earlier line.\n for (let attempt = 0; ; attempt++) {\n const current = await context.store.getActiveRevision(turn.workspaceId, turn.profileId)\n if (!current) throw new ProfileConflictError('Profile revision is unavailable')\n if (current.knowledgeText.split('\\n').some(existing => existing.trim() === line)) {\n return { profileId: turn.profileId, revisionId: current.id, saved: true, alreadyKnown: true,\n line, appliesTo: 'next_message' }\n }\n const knowledgeText = current.knowledgeText.trim() ? `${current.knowledgeText.trimEnd()}\\n${line}` : line\n if (knowledgeText.length > KNOWLEDGE_TEXT_MAX) {\n throw new ProfileConflictError('Knowledge is full; ask the owner to edit it before saving more')\n }\n try {\n const revision = await proposeRevision({ store: context.storeForTurn?.(turn) ?? context.store,\n workspaceId: turn.workspaceId, profileId: turn.profileId, expectedRevisionId: current.id,\n profile: current.profile, knowledgeText,\n planDigest: await context.planDigest(current.profile, knowledgeText),\n author: { kind: 'agent', id: turn.memberId }, actorRole: turn.role,\n reason: 'Owner or manager asked the agent to remember a fact during chat' })\n return { profileId: turn.profileId, revisionId: revision.id, saved: revision.state === 'active',\n state: revision.state, alreadyKnown: false, line, appliesTo: 'next_message' }\n } catch (error) {\n if (!(error instanceof ProfileConflictError) || attempt > 0) throw error\n }\n }\n },\n }]\n}\n\nexport * from './self-management'\nexport * from './release'\n","/**\n * Live profile self-mounting — the safe, immediate subset of agent\n * self-improvement.\n *\n * The revision system ({@link ProfileRevision}, `PROFILE_CHANGE_POLICY`) owns\n * durable profile evolution: authority edits need editor consent, optimizer\n * revisions promote through eval. Self-mounting is the complementary\n * LIVE dimension — the sandboxed agent adjusts its own mounted context\n * (skills today) within a permitted, idempotent, catalog-validated delta.\n * Nothing here touches authority: model, permissions, tools denials and\n * billing identity are not agent-changeable dimensions, and every refusal\n * names the permitted set.\n *\n * One audited verb, not a family: `mount_profile_change` applies a validated\n * delta against a permitted-dimensions allowlist; re-applying the same delta\n * is a no-op; the baseline skill cannot be removed; the mount count is capped\n * because context is a budget.\n *\n * Products wire their own catalog and persistence:\n *\n * ```ts\n * import { createMountProfileChangeTool, createInMemorySelfMountStorage } from '@tangle-network/agent-app/agent-profiles'\n *\n * const mountProfileChange = createMountProfileChangeTool({\n * skills: mySkillRegistry, // { id, description }[]\n * storage: createD1SelfMountStorage(env.DB), // or any { get, set }\n * scopeKey: (ctx) => ctx.threadId ?? ctx.userId, // product's persistence scope\n * baseline: 'cad',\n * })\n * ```\n */\nimport { defineAppTool, type AppToolDefinition } from '../tools/registry'\nimport { ToolInputError } from '../tools/errors'\nimport type { AppToolContext } from '../tools/types'\n\n/** The only profile dimensions an agent may change on its own mounted state.\n * Anything else in a delta is refused with this list — the boundary is the\n * schema, not the verb count. */\nexport const PERMITTED_SELF_MOUNT_DIMENSIONS = ['skills'] as const\n\nexport interface SelfMountSkillEntry {\n /** Registry-unique skill id. */\n id: string\n /** One-line description, surfaced in the tool's catalog. */\n description: string\n}\n\n/** Durable mounted-skill state, keyed by the product's scope. */\nexport interface SelfMountStorage {\n get(scope: string): Promise<readonly string[]>\n set(scope: string, ids: readonly string[]): Promise<void>\n}\n\n/** Non-durable default for tests and single-instance products. */\nexport function createInMemorySelfMountStorage(): SelfMountStorage {\n const state = new Map<string, string[]>()\n return {\n async get(scope) {\n return state.get(scope) ?? []\n },\n async set(scope, ids) {\n state.set(scope, [...new Set(ids)].sort())\n },\n }\n}\n\nexport interface MountProfileChangeDeps {\n /** The product's skill catalog — the only mountable ids. */\n skills: readonly SelfMountSkillEntry[]\n /** Where mounted ids persist, keyed by the product's scope. */\n storage: SelfMountStorage\n /** The persistence scope for a call (project id, thread id, …). */\n scopeKey: (ctx: AppToolContext) => string\n /** Always-mounted skill id that cannot be removed. Default: none. */\n baseline?: string\n /** Upper bound on total mounted skills. Default 12; context is a budget. */\n maxMounted?: number\n /** Tool name override when a product needs a distinct verb. */\n name?: string\n}\n\ninterface SkillsDelta {\n add?: string[]\n remove?: string[]\n}\n\nexport interface MountProfileChangeResult {\n ok: true\n mounted: string[]\n removed: string[]\n effective: string[]\n note: string\n}\n\nfunction catalogLine(skills: readonly SelfMountSkillEntry[]): string {\n return skills.map((s) => `${s.id} (${s.description})`).join('; ')\n}\n\n/**\n * The permitted, idempotent self-mount verb as an app tool. Register it with\n * the product's tool set; the sandboxed agent calls it through the per-turn\n * MCP surface like any other app tool.\n */\nexport function createMountProfileChangeTool(deps: MountProfileChangeDeps): AppToolDefinition<Record<string, unknown>> {\n const { skills, storage, scopeKey } = deps\n const baseline = deps.baseline?.trim() || undefined\n const maxMounted = deps.maxMounted ?? 12\n const known = new Set(skills.map((s) => s.id))\n if (known.size !== skills.length) throw new Error('createMountProfileChangeTool: duplicate skill ids in the catalog')\n if (baseline && !known.has(baseline)) throw new Error(`createMountProfileChangeTool: baseline \"${baseline}\" is not in the catalog`)\n\n return defineAppTool({\n name: deps.name ?? 'mount_profile_change',\n description:\n `Apply a permitted, idempotent change to the mounted skills on this profile. ` +\n `Permitted dimension: skills ({ add: [ids], remove: [ids] }) — anything else is refused. ` +\n `Re-applying the same change is a no-op. Takes effect the next time the profile renders. ` +\n `Catalog: ${catalogLine(skills)}.`,\n parameters: {\n type: 'object',\n properties: {\n changes: {\n type: 'object',\n description: `The profile delta. Permitted dimensions: ${PERMITTED_SELF_MOUNT_DIMENSIONS.join(', ')}.`,\n properties: {\n skills: {\n type: 'object',\n description: 'Skill mounts: catalog ids to add or remove.',\n properties: {\n add: { type: 'array', items: { type: 'string' }, description: 'Catalog skill ids to mount.' },\n remove: { type: 'array', items: { type: 'string' }, description: 'Mounted skill ids to unmount.' },\n },\n additionalProperties: false,\n },\n },\n additionalProperties: false,\n },\n },\n required: ['changes'],\n additionalProperties: false,\n },\n async execute(args: unknown, ctx: AppToolContext): Promise<MountProfileChangeResult | { ok: false; error: string }> {\n const changes = (args as { changes?: Record<string, unknown> }).changes ?? {}\n const unknownDimensions = Object.keys(changes).filter(\n (d) => !(PERMITTED_SELF_MOUNT_DIMENSIONS as readonly string[]).includes(d),\n )\n if (unknownDimensions.length > 0) {\n throw new ToolInputError(\n 'mount_profile_change',\n `dimensions [${unknownDimensions.join(', ')}] are not agent-changeable. Permitted dimensions: ${PERMITTED_SELF_MOUNT_DIMENSIONS.join(', ')}.`,\n )\n }\n const delta = (changes.skills ?? {}) as SkillsDelta\n const add = [...new Set((delta.add ?? []).map((s) => s.trim()).filter(Boolean))]\n const remove = [...new Set((delta.remove ?? []).map((s) => s.trim()).filter(Boolean))]\n if (add.length === 0 && remove.length === 0) {\n throw new ToolInputError('mount_profile_change', 'empty delta: provide skills.add and/or skills.remove')\n }\n const invalid = [...add, ...remove].filter((id) => !known.has(id))\n if (invalid.length > 0) {\n throw new ToolInputError(\n 'mount_profile_change',\n `unknown skill ids: ${invalid.join(', ')}. Catalog: ${[...known].sort().join(', ')}.`)\n }\n if (baseline && remove.includes(baseline)) {\n throw new ToolInputError(\n 'mount_profile_change',\n `refused: \"${baseline}\" is the always-on baseline and cannot be removed`)\n }\n\n const scope = scopeKey(ctx)\n const stored = await storage.get(scope)\n const before = [...new Set([...stored, ...(baseline ? [baseline] : [])])].sort()\n const mounted = new Set(before)\n for (const id of add) mounted.add(id)\n for (const id of remove) mounted.delete(id)\n if (baseline) mounted.add(baseline)\n const effective = [...mounted].sort()\n if (effective.length > maxMounted) {\n throw new ToolInputError(\n 'mount_profile_change',\n `refused: ${effective.length} skills exceeds the ${maxMounted}-skill mount limit`)\n }\n if (JSON.stringify(before) === JSON.stringify(effective)) {\n return { ok: true, mounted: [], removed: [], effective, note: 'no change (already in that state) — idempotent no-op' }\n }\n await storage.set(scope, effective)\n return {\n ok: true,\n mounted: effective.filter((id) => !before.includes(id)),\n removed: before.filter((id) => !effective.includes(id)),\n effective,\n note: 'applied — takes effect the next time the profile renders',\n }\n },\n })\n}\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n/** Any drizzle database instance (structural — the adapters only use\n * select/insert with the standard builder chain). */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype DrizzleLike = any\n\n// ── Shared storage adapters ────────────────────────────────────────────────\n//\n// Every product's self-mount storage is the same shape: a scope key and a\n// JSON list of mounted skill ids. These adapters mean each product wires\n// the verb in 3 lines instead of hand-writing a drizzle query.\n\nimport type { drizzle as drizzleD1 } from 'drizzle-orm/d1'\nimport { eq } from 'drizzle-orm'\nimport { sqliteTable, text } from 'drizzle-orm/sqlite-core'\n\n/** Create (or use) the standard self-mount table in a drizzle/D1 database. */\nfunction selfMountTable(tableName: string) {\n return sqliteTable(tableName, {\n scope: text('scope').primaryKey(),\n mounted: text('mounted').notNull(),\n })\n}\n\n/** A drizzle-backed SelfMountStorage against any table with the standard\n * shape (scope primary key + mounted JSON text column). Works with the\n * tables every product creates via {@link selfMountTable}. */\nfunction createDrizzleSelfMountStorage(\n db: DrizzleLike,\n table: ReturnType<typeof selfMountTable>,\n baseline: string,\n): SelfMountStorage {\n return {\n async get(scope: string): Promise<readonly string[]> {\n const rows = await db\n .select({ mounted: table.mounted })\n .from(table)\n .where(eq(table.scope, scope))\n .limit(1)\n try {\n return rows[0] ? (JSON.parse(rows[0].mounted) as string[]) : [baseline]\n } catch {\n return [baseline]\n }\n },\n async set(scope: string, ids: readonly string[]): Promise<void> {\n await db\n .insert(table)\n .values({ scope, mounted: JSON.stringify(ids) })\n .onConflictDoUpdate({\n target: table.scope,\n set: { mounted: JSON.stringify(ids) },\n })\n },\n }\n}\n\n/** A KV-backed SelfMountStorage (Cloudflare KV, any namespace). */\nfunction createKVSelfMountStorage(\n kv: { get(key: string): Promise<string | null>; put(key: string, value: string): Promise<void> },\n prefix: string,\n baseline: string,\n): SelfMountStorage {\n const key = (scope: string) => `${prefix}:${scope}`\n return {\n async get(scope: string): Promise<readonly string[]> {\n const raw = await kv.get(key(scope))\n try { return raw ? (JSON.parse(raw) as string[]) : [baseline] } catch { return [baseline] }\n },\n async set(scope: string, ids: readonly string[]): Promise<void> {\n await kv.put(key(scope), JSON.stringify(ids))\n },\n }\n}\n\n/** The one-call product wiring: catalog + storage + baseline + cap. */\nexport interface ProductSelfMountConfig {\n /** The product's skill catalog (id + description per skill). */\n skills: ReadonlyArray<{ id: string; description: string }>\n /** A drizzle/D1 database (uses a self-mount table) or a KV namespace. */\n db?: DrizzleLike\n kv?: { get(key: string): Promise<string | null>; put(key: string, value: string): Promise<void> }\n /** The table name for drizzle storage (default: 'agent_self_mounts'). */\n tableName?: string\n /** KV prefix (default: 'self-mount'). */\n kvPrefix?: string\n /** The skill id that can never be removed. */\n baseline: string\n /** Max simultaneous mounts (default: 12). */\n maxMounted?: number\n}\n\nexport function createProductSelfMount(config: ProductSelfMountConfig) {\n const storage = config.db\n ? createDrizzleSelfMountStorage(config.db, selfMountTable(config.tableName ?? 'agent_self_mounts'), config.baseline)\n : config.kv\n ? createKVSelfMountStorage(config.kv, config.kvPrefix ?? 'self-mount', config.baseline)\n : undefined\n if (!storage) throw new Error('createProductSelfMount needs db or kv')\n return createMountProfileChangeTool({\n skills: config.skills,\n storage,\n scopeKey: (ctx) => ctx.workspaceId ?? ctx.threadId ?? '',\n baseline: config.baseline,\n maxMounted: config.maxMounted ?? 12,\n })\n}\n","/**\n * A stored profile runs the current product release plus its own changes.\n *\n * Revisions are complete AgentProfile snapshots, so a workspace's import carries a copy of the product text current\n * when it was made, and that copy goes stale with the next release. A turn resolves the stored profile over the\n * release serving it: text equal to a version the product shipped (the release's own, or one in the workspace's\n * history) is product text and runs as the release's; text that matches no shipped version is the workspace's own\n * and stays. Nothing stored is rewritten.\n *\n * Only `prompt.systemPrompt` follows a release. No product profile ships `prompt.instructions` (2026-11-15: Creative,\n * Legal, Hardware, Tax and GTM set only the system prompt there); instructions in a stored revision are a person's.\n */\nimport { canonicalCandidateDigest, snapshotAgentProfile, type AgentProfile } from '@tangle-network/agent-interface'\nimport type { ProfilePromptHistoryEntry, ProfileRevision, ProfileRevisionStore } from './index'\n\ntype SkillRef = NonNullable<NonNullable<AgentProfile['resources']>['skills']>[number]\ntype Specialist = NonNullable<AgentProfile['subagents']>[string]\n\n/** How a stored profile's text compares with the current release; `customized` text is the workspace's own and stays. */\nexport interface ProfileReleaseUpdates {\n systemPrompt: 'current' | 'outdated' | 'customized'\n specialists: { updated: string[]; customized: string[] }\n skills: {\n added: string[]\n updated: string[]\n removed: string[]\n /** Built-in skills this workspace edited; they stay as they are. */\n customized: string[]\n }\n}\n\n/** The longest history read; a longer one reads as incomplete, so its prompt is kept. The D1 case in\n * tests/agent-profiles-pin.integration.test.ts reads a history this long with 20 KB prompts. */\nexport const PROFILE_PROMPT_HISTORY_MAX = 1_000\n\nconst skillName = (skill: SkillRef) => skill.name ?? (skill.kind === 'github' ? skill.path : '')\nconst digest = (value: unknown) => canonicalCandidateDigest(value ?? null)\n\n/**\n * The active profile's skills with built-ins brought to the release. A built-in counts as untouched while it\n * matches a version the product shipped (`shipped`); edited built-ins and workspace skills are kept.\n */\nexport function refreshBuiltinSkills(active: AgentProfile, shipped: readonly SkillRef[], release: AgentProfile):\n { skills: SkillRef[]; updates: ProfileReleaseUpdates['skills'] } {\n const current = release.resources?.skills ?? []\n const currentByName = new Map(current.map(skill => [skillName(skill), skill]))\n const shippedNames = new Set(shipped.map(skillName))\n const shippedDigests = new Set(shipped.map(digest))\n const updates: ProfileReleaseUpdates['skills'] = { added: [], updated: [], removed: [], customized: [] }\n const skills: SkillRef[] = []\n for (const skill of active.resources?.skills ?? []) {\n const name = skillName(skill)\n const next = currentByName.get(name)\n const builtin = next !== undefined || shippedNames.has(name)\n if (!builtin || (next && digest(skill) === digest(next))) { skills.push(skill); continue }\n if (!shippedDigests.has(digest(skill))) { updates.customized.push(name); skills.push(skill); continue }\n if (next) { updates.updated.push(name); skills.push(next) } else updates.removed.push(name)\n }\n const present = new Set(skills.map(skillName))\n for (const skill of current) {\n if (present.has(skillName(skill))) continue\n updates.added.push(skillName(skill))\n skills.push(skill)\n }\n return { skills, updates }\n}\n\n/**\n * Resolve a stored profile over the release. `shipped` holds every complete profile the product delivered to this\n * workspace (its import and each release refresh). The system prompt, specialists, built-in skills and every\n * executable control come from the release; the workspace keeps the text it wrote.\n */\nexport function overlayOnRelease(stored: AgentProfile, shipped: readonly AgentProfile[], release: AgentProfile):\n { profile: AgentProfile; updates: ProfileReleaseUpdates } {\n const product = [release, ...shipped]\n const storedPrompt = stored.prompt?.systemPrompt\n const promptCustomized = storedPrompt !== undefined && !product.some(profile => profile.prompt?.systemPrompt === storedPrompt)\n const systemPrompt = promptCustomized ? storedPrompt : release.prompt?.systemPrompt\n const instructions = stored.prompt?.instructions\n\n const subagents: Record<string, Specialist> = { ...release.subagents }\n const specialists: ProfileReleaseUpdates['specialists'] = { updated: [], customized: [] }\n for (const [id, mine] of Object.entries(stored.subagents ?? {})) {\n const versions = product.map(profile => profile.subagents?.[id]).filter((value): value is Specialist => value !== undefined)\n const ownPrompt = mine.prompt !== undefined && !versions.some(version => version.prompt === mine.prompt)\n const ownDescription = mine.description !== undefined && !versions.some(version => version.description === mine.description)\n const next = release.subagents?.[id]\n if (ownPrompt || ownDescription) {\n specialists.customized.push(id)\n subagents[id] = { ...(next ?? mine),\n ...(ownPrompt ? { prompt: mine.prompt } : {}), ...(ownDescription ? { description: mine.description } : {}) }\n } else if (next && (next.prompt !== mine.prompt || next.description !== mine.description)) specialists.updated.push(id)\n }\n\n const { skills, updates: skillUpdates } = refreshBuiltinSkills(stored,\n shipped.flatMap(profile => profile.resources?.skills ?? []), release)\n const releaseFiles = release.resources?.files ?? []\n const releasePaths = new Set(releaseFiles.map(file => file.path))\n const files = [...releaseFiles, ...(stored.resources?.files ?? []).filter(file => !releasePaths.has(file.path))]\n\n const prompt = { ...release.prompt,\n ...(systemPrompt === undefined ? {} : { systemPrompt }), ...(instructions === undefined ? {} : { instructions }) }\n if (systemPrompt === undefined) delete prompt.systemPrompt\n const profile = snapshotAgentProfile({ ...release,\n ...(stored.name === undefined ? {} : { name: stored.name }),\n ...(stored.description === undefined ? {} : { description: stored.description }),\n ...(Object.keys(prompt).length ? { prompt } : {}),\n ...(Object.keys(subagents).length ? { subagents } : {}),\n resources: { ...release.resources, skills, ...(files.length ? { files } : {}) },\n })\n return { profile, updates: {\n systemPrompt: promptCustomized ? 'customized' : storedPrompt === release.prompt?.systemPrompt ? 'current' : 'outdated',\n specialists, skills: skillUpdates,\n } }\n}\n\nasync function promptHistory(store: ProfileRevisionStore, revision: ProfileRevision): Promise<ProfilePromptHistoryEntry[]> {\n if (store.readPromptHistory) return store.readPromptHistory(revision.workspaceId, revision.profileId, revision.id)\n const newest = revision.profile.prompt?.systemPrompt\n const history: ProfilePromptHistoryEntry[] = []\n for (let current: ProfileRevision | null = revision; current && history.length < PROFILE_PROMPT_HISTORY_MAX;) {\n const prompt = current.profile.prompt?.systemPrompt\n const parent: ProfileRevision | null = current.parentId\n ? await store.getRevision(revision.workspaceId, revision.profileId, current.parentId) : null\n history.push({ id: current.id, parentId: current.parentId, author: current.author, sameAsNewest: prompt === newest,\n sameAsParent: parent ? parent.profile.prompt?.systemPrompt === prompt : null })\n current = parent\n }\n return history\n}\n\n/**\n * Whether a revision's system prompt is one the product shipped into its history: some revision by a product author\n * has that prompt and differs from its parent's (an import, or a release refresh). A product revision that carries\n * its parent's prompt forward ships nothing, so a person's text a release copied stays theirs. An incomplete history\n * (a missing ancestor, or a longer one than `PROFILE_PROMPT_HISTORY_MAX`) shows nothing to be the product's.\n */\nexport async function promptShippedByProduct(store: ProfileRevisionStore, revision: ProfileRevision,\n productAuthorIds: readonly string[]): Promise<boolean> {\n const history = await promptHistory(store, revision)\n let shipped = false\n for (const [index, entry] of history.entries()) {\n const parent = history[index + 1]\n if (entry.parentId !== null && parent?.id !== entry.parentId) return false\n if (entry.sameAsNewest && productAuthorIds.includes(entry.author.id) &&\n (entry.parentId === null || entry.sameAsParent === false)) shipped = true\n }\n return shipped\n}\n\n/** Whether a revision's stored prompt is product text, per product author ids. Revisions and their history are\n * immutable, so an answer never changes. */\nconst productPromptRevisions = new Map<string, boolean>()\nconst PRODUCT_PROMPT_REVISIONS_MAX = 10_000\n\n/**\n * The profile a turn runs for `revision`: the stored profile with the release's system prompt where the stored prompt\n * is one the product shipped into its history (`promptShippedByProduct`, revisions whose author id is in\n * `productAuthorIds`) or absent; unchanged, and returned as is, where a person wrote it. Only the system prompt\n * moves; authority, name, description and instructions stay. The history is read once per revision and isolate, in\n * one round trip on the D1 store, and not at all when the stored prompt already is the release's. A plan digest\n * computed from the result moves with each release, so a product's `verifyEffectivePlan` must compute it from this\n * function's result too.\n */\nexport async function followProductRelease(store: ProfileRevisionStore, revision: ProfileRevision,\n release: AgentProfile, productAuthorIds: readonly string[]): Promise<AgentProfile> {\n const stored = revision.profile\n const storedPrompt = stored.prompt?.systemPrompt\n const releasePrompt = release.prompt?.systemPrompt\n if (storedPrompt === releasePrompt) return stored\n if (storedPrompt !== undefined) {\n const key = JSON.stringify([[...productAuthorIds].sort(), revision.workspaceId, revision.profileId, revision.id])\n let product = productPromptRevisions.get(key)\n if (product === undefined) {\n product = await promptShippedByProduct(store, revision, productAuthorIds)\n productPromptRevisions.set(key, product)\n const oldest = productPromptRevisions.keys().next().value\n if (productPromptRevisions.size > PRODUCT_PROMPT_REVISIONS_MAX && oldest !== undefined) productPromptRevisions.delete(oldest)\n }\n if (!product) return stored\n }\n const { systemPrompt: _stored, ...rest } = stored.prompt ?? {}\n const prompt = releasePrompt === undefined ? rest : { ...rest, systemPrompt: releasePrompt }\n const { prompt: _prompt, ...profile } = stored\n return snapshotAgentProfile(Object.keys(prompt).length ? { ...profile, prompt } : profile)\n}\n"],"mappings":"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","names":["snapshotAgentProfile","profile","snapshotAgentProfile","profile","text"]}
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  checkDeployedApp
4
- } from "../chunk-PABZALSD.js";
4
+ } from "../chunk-LBMFQLBS.js";
5
5
  import "../chunk-EI27JMS6.js";
6
6
  import {
7
7
  invokedAsScript
@@ -31,7 +31,7 @@ function parseConformanceArgs(argv, env = process.env) {
31
31
  const mode = flags.get("--auth") ?? "password";
32
32
  if (mode !== "password" && mode !== "sso") throw new Error("--auth is password or sso");
33
33
  const computer = flags.get("--computer") ?? "digest";
34
- if (computer !== "digest" && computer !== "file") throw new Error("--computer is digest or file");
34
+ if (computer !== "digest" && computer !== "file" && computer !== "none") throw new Error("--computer is digest, file or none");
35
35
  const turnMs = Number(flags.get("--turn-ms") ?? 3e5);
36
36
  if (!Number.isFinite(turnMs) || turnMs < 1e3) throw new Error("--turn-ms is a number of milliseconds, at least 1000");
37
37
  const email = flags.get("--email") ?? env.CONFORMANCE_EMAIL?.trim();
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/conformance/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `agent-app-conformance` — the basics every deployed agent app must do, checked against its production origin:\n * sign in, read the served revision, answer a plain turn, and answer a turn only the workspace computer can.\n * It prints one JSON line per check as the check ends: app, url, check, status, ms, and the cause of a failure.\n *\n * agent-app-conformance --app-url https://gtm.tangle.tools --auth password --workspace \"GTM release canary\"\n *\n * The member comes from the environment so it never reaches a process listing:\n * CONFORMANCE_EMAIL, CONFORMANCE_PASSWORD the canary member (--email / --password are accepted but visible to `ps`)\n * CONFORMANCE_OPERATOR_KEY optional: an operator key with operator:read and operator:run;\n * without one the signed-in member mints an hour-long key and revokes it\n *\n * Options:\n * --app-url <origin> required\n * --app <label> names the app in each line (default: the origin's first host label)\n * --auth password|sso how the member signs in (default password); sso goes through Tangle Platform\n * --workspace <id|name> the canary or smoke workspace the turns run in (default: the key's only workspace)\n * --computer digest|file digest: hash a fresh nonce on the computer; file: the computer saves a file the app serves back\n * --computer-model <id> the computer turn's model (default glm-5.3, flat-rate); the plain turn keeps the app's model\n * --file-dir <dir> where the file proof is saved (default proof)\n * --turn-ms <ms> the budget of each turn, a cold box included (default 300000)\n * --expect-revision <sha> fail unless the served revision matches\n *\n * Exits 0 when every check passes, 1 when any fails or is blocked, 2 on a usage error.\n */\nimport { invokedAsScript } from '../signoff/invoked-as-script.js'\nimport { checkDeployedApp, type ConformanceOptions } from './run.js'\nimport type { ComputerProof } from './turns.js'\nimport type { SignInMode } from './session.js'\n\nconst VALUE_FLAGS = new Set(['--app-url', '--app', '--auth', '--email', '--password', '--workspace', '--computer', '--computer-model', '--file-dir', '--turn-ms', '--expect-revision'])\n\nfunction parseConformanceArgs(argv: readonly string[], env: NodeJS.ProcessEnv = process.env): ConformanceOptions {\n const flags = new Map<string, string>()\n for (let index = 0; index < argv.length; index += 1) {\n const [flag = '', inline] = argv[index]!.split(/=(.*)/s, 2)\n if (!VALUE_FLAGS.has(flag)) throw new Error(`unknown option ${argv[index]}`)\n const value = inline ?? argv[++index]\n if (value === undefined || value === '') throw new Error(`${flag} needs a value`)\n flags.set(flag, value)\n }\n const url = flags.get('--app-url')\n if (!url) throw new Error('--app-url is required')\n let origin: URL\n try { origin = new URL(url) } catch { throw new Error(`--app-url is not a URL: ${url}`) }\n if (origin.protocol !== 'https:') throw new Error('--app-url must be an https origin')\n const mode = flags.get('--auth') ?? 'password'\n if (mode !== 'password' && mode !== 'sso') throw new Error('--auth is password or sso')\n const computer = flags.get('--computer') ?? 'digest'\n if (computer !== 'digest' && computer !== 'file') throw new Error('--computer is digest or file')\n const turnMs = Number(flags.get('--turn-ms') ?? 300_000)\n if (!Number.isFinite(turnMs) || turnMs < 1_000) throw new Error('--turn-ms is a number of milliseconds, at least 1000')\n const email = flags.get('--email') ?? env.CONFORMANCE_EMAIL?.trim()\n const password = flags.get('--password') ?? env.CONFORMANCE_PASSWORD\n const operatorKey = env.CONFORMANCE_OPERATOR_KEY?.trim()\n return {\n app: flags.get('--app') ?? origin.hostname.split('.')[0]!,\n origin: origin.origin,\n ...(email && password ? { member: { mode: mode as SignInMode, email, password } } : {}),\n ...(operatorKey ? { operatorKey } : {}),\n ...(flags.has('--workspace') ? { workspace: flags.get('--workspace')! } : {}),\n computer: computer as ComputerProof,\n ...(flags.has('--computer-model') ? { computerModel: flags.get('--computer-model')! } : {}),\n ...(flags.has('--file-dir') ? { fileDir: flags.get('--file-dir')! } : {}),\n turnMs,\n ...(flags.has('--expect-revision') ? { expectRevision: flags.get('--expect-revision')! } : {}),\n }\n}\n\nasync function main(): Promise<number> {\n let options: ConformanceOptions\n try {\n options = parseConformanceArgs(process.argv.slice(2))\n } catch (error) {\n console.error(`agent-app-conformance: ${error instanceof Error ? error.message : String(error)}`)\n return 2\n }\n const results = await checkDeployedApp({ ...options, onResult: result => process.stdout.write(`${JSON.stringify(result)}\\n`) })\n return results.every(result => result.status === 'pass') ? 0 : 1\n}\n\nif (invokedAsScript(import.meta.url, process.argv[1])) {\n main().then(code => process.stdout.write('', () => process.exit(code)))\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../src/conformance/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `agent-app-conformance` — the basics every deployed agent app must do, checked against its production origin:\n * sign in, read the served revision, answer a plain turn, and answer a turn only the workspace computer can.\n * It prints one JSON line per check as the check ends: app, url, check, status, ms, and the cause of a failure.\n *\n * agent-app-conformance --app-url https://gtm.tangle.tools --auth password --workspace \"GTM release canary\"\n *\n * The member comes from the environment so it never reaches a process listing:\n * CONFORMANCE_EMAIL, CONFORMANCE_PASSWORD the canary member (--email / --password are accepted but visible to `ps`)\n * CONFORMANCE_OPERATOR_KEY optional: an operator key with operator:read and operator:run;\n * without one the signed-in member mints an hour-long key and revokes it\n *\n * Options:\n * --app-url <origin> required\n * --app <label> names the app in each line (default: the origin's first host label)\n * --auth password|sso how the member signs in (default password); sso goes through Tangle Platform\n * --workspace <id|name> the canary or smoke workspace the turns run in (default: the key's only workspace)\n * --computer digest|file|none digest: hash a fresh nonce on the computer; file: the computer saves a file the app\n * serves back; none: the plain turn only (one ask, for a post-serve first-ask check)\n * --computer-model <id> the computer turn's model (default glm-5.3, flat-rate); the plain turn keeps the app's model\n * --file-dir <dir> where the file proof is saved (default proof)\n * --turn-ms <ms> the budget of each turn, a cold box included (default 300000)\n * --expect-revision <sha> fail unless the served revision matches\n *\n * Exits 0 when every check passes, 1 when any fails or is blocked, 2 on a usage error.\n */\nimport { invokedAsScript } from '../signoff/invoked-as-script.js'\nimport { checkDeployedApp, type ConformanceOptions } from './run.js'\nimport type { ComputerProof } from './turns.js'\nimport type { SignInMode } from './session.js'\n\nconst VALUE_FLAGS = new Set(['--app-url', '--app', '--auth', '--email', '--password', '--workspace', '--computer', '--computer-model', '--file-dir', '--turn-ms', '--expect-revision'])\n\nfunction parseConformanceArgs(argv: readonly string[], env: NodeJS.ProcessEnv = process.env): ConformanceOptions {\n const flags = new Map<string, string>()\n for (let index = 0; index < argv.length; index += 1) {\n const [flag = '', inline] = argv[index]!.split(/=(.*)/s, 2)\n if (!VALUE_FLAGS.has(flag)) throw new Error(`unknown option ${argv[index]}`)\n const value = inline ?? argv[++index]\n if (value === undefined || value === '') throw new Error(`${flag} needs a value`)\n flags.set(flag, value)\n }\n const url = flags.get('--app-url')\n if (!url) throw new Error('--app-url is required')\n let origin: URL\n try { origin = new URL(url) } catch { throw new Error(`--app-url is not a URL: ${url}`) }\n if (origin.protocol !== 'https:') throw new Error('--app-url must be an https origin')\n const mode = flags.get('--auth') ?? 'password'\n if (mode !== 'password' && mode !== 'sso') throw new Error('--auth is password or sso')\n const computer = flags.get('--computer') ?? 'digest'\n if (computer !== 'digest' && computer !== 'file' && computer !== 'none') throw new Error('--computer is digest, file or none')\n const turnMs = Number(flags.get('--turn-ms') ?? 300_000)\n if (!Number.isFinite(turnMs) || turnMs < 1_000) throw new Error('--turn-ms is a number of milliseconds, at least 1000')\n const email = flags.get('--email') ?? env.CONFORMANCE_EMAIL?.trim()\n const password = flags.get('--password') ?? env.CONFORMANCE_PASSWORD\n const operatorKey = env.CONFORMANCE_OPERATOR_KEY?.trim()\n return {\n app: flags.get('--app') ?? origin.hostname.split('.')[0]!,\n origin: origin.origin,\n ...(email && password ? { member: { mode: mode as SignInMode, email, password } } : {}),\n ...(operatorKey ? { operatorKey } : {}),\n ...(flags.has('--workspace') ? { workspace: flags.get('--workspace')! } : {}),\n computer: computer as ComputerProof | 'none',\n ...(flags.has('--computer-model') ? { computerModel: flags.get('--computer-model')! } : {}),\n ...(flags.has('--file-dir') ? { fileDir: flags.get('--file-dir')! } : {}),\n turnMs,\n ...(flags.has('--expect-revision') ? { expectRevision: flags.get('--expect-revision')! } : {}),\n }\n}\n\nasync function main(): Promise<number> {\n let options: ConformanceOptions\n try {\n options = parseConformanceArgs(process.argv.slice(2))\n } catch (error) {\n console.error(`agent-app-conformance: ${error instanceof Error ? error.message : String(error)}`)\n return 2\n }\n const results = await checkDeployedApp({ ...options, onResult: result => process.stdout.write(`${JSON.stringify(result)}\\n`) })\n return results.every(result => result.status === 'pass') ? 0 : 1\n}\n\nif (invokedAsScript(import.meta.url, process.argv[1])) {\n main().then(code => process.stdout.write('', () => process.exit(code)))\n}\n"],"mappings":";;;;;;;;;;;AAgCA,IAAM,cAAc,oBAAI,IAAI,CAAC,aAAa,SAAS,UAAU,WAAW,cAAc,eAAe,cAAc,oBAAoB,cAAc,aAAa,mBAAmB,CAAC;AAEtL,SAAS,qBAAqB,MAAyB,MAAyB,QAAQ,KAAyB;AAC/G,QAAM,QAAQ,oBAAI,IAAoB;AACtC,WAAS,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;AACnD,UAAM,CAAC,OAAO,IAAI,MAAM,IAAI,KAAK,KAAK,EAAG,MAAM,UAAU,CAAC;AAC1D,QAAI,CAAC,YAAY,IAAI,IAAI,EAAG,OAAM,IAAI,MAAM,kBAAkB,KAAK,KAAK,CAAC,EAAE;AAC3E,UAAM,QAAQ,UAAU,KAAK,EAAE,KAAK;AACpC,QAAI,UAAU,UAAa,UAAU,GAAI,OAAM,IAAI,MAAM,GAAG,IAAI,gBAAgB;AAChF,UAAM,IAAI,MAAM,KAAK;AAAA,EACvB;AACA,QAAM,MAAM,MAAM,IAAI,WAAW;AACjC,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,uBAAuB;AACjD,MAAI;AACJ,MAAI;AAAE,aAAS,IAAI,IAAI,GAAG;AAAA,EAAE,QAAQ;AAAE,UAAM,IAAI,MAAM,2BAA2B,GAAG,EAAE;AAAA,EAAE;AACxF,MAAI,OAAO,aAAa,SAAU,OAAM,IAAI,MAAM,mCAAmC;AACrF,QAAM,OAAO,MAAM,IAAI,QAAQ,KAAK;AACpC,MAAI,SAAS,cAAc,SAAS,MAAO,OAAM,IAAI,MAAM,2BAA2B;AACtF,QAAM,WAAW,MAAM,IAAI,YAAY,KAAK;AAC5C,MAAI,aAAa,YAAY,aAAa,UAAU,aAAa,OAAQ,OAAM,IAAI,MAAM,oCAAoC;AAC7H,QAAM,SAAS,OAAO,MAAM,IAAI,WAAW,KAAK,GAAO;AACvD,MAAI,CAAC,OAAO,SAAS,MAAM,KAAK,SAAS,IAAO,OAAM,IAAI,MAAM,sDAAsD;AACtH,QAAM,QAAQ,MAAM,IAAI,SAAS,KAAK,IAAI,mBAAmB,KAAK;AAClE,QAAM,WAAW,MAAM,IAAI,YAAY,KAAK,IAAI;AAChD,QAAM,cAAc,IAAI,0BAA0B,KAAK;AACvD,SAAO;AAAA,IACL,KAAK,MAAM,IAAI,OAAO,KAAK,OAAO,SAAS,MAAM,GAAG,EAAE,CAAC;AAAA,IACvD,QAAQ,OAAO;AAAA,IACf,GAAI,SAAS,WAAW,EAAE,QAAQ,EAAE,MAA0B,OAAO,SAAS,EAAE,IAAI,CAAC;AAAA,IACrF,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC;AAAA,IACrC,GAAI,MAAM,IAAI,aAAa,IAAI,EAAE,WAAW,MAAM,IAAI,aAAa,EAAG,IAAI,CAAC;AAAA,IAC3E;AAAA,IACA,GAAI,MAAM,IAAI,kBAAkB,IAAI,EAAE,eAAe,MAAM,IAAI,kBAAkB,EAAG,IAAI,CAAC;AAAA,IACzF,GAAI,MAAM,IAAI,YAAY,IAAI,EAAE,SAAS,MAAM,IAAI,YAAY,EAAG,IAAI,CAAC;AAAA,IACvE;AAAA,IACA,GAAI,MAAM,IAAI,mBAAmB,IAAI,EAAE,gBAAgB,MAAM,IAAI,mBAAmB,EAAG,IAAI,CAAC;AAAA,EAC9F;AACF;AAEA,eAAe,OAAwB;AACrC,MAAI;AACJ,MAAI;AACF,cAAU,qBAAqB,QAAQ,KAAK,MAAM,CAAC,CAAC;AAAA,EACtD,SAAS,OAAO;AACd,YAAQ,MAAM,0BAA0B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAChG,WAAO;AAAA,EACT;AACA,QAAM,UAAU,MAAM,iBAAiB,EAAE,GAAG,SAAS,UAAU,YAAU,QAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,MAAM,CAAC;AAAA,CAAI,EAAE,CAAC;AAC9H,SAAO,QAAQ,MAAM,YAAU,OAAO,WAAW,MAAM,IAAI,IAAI;AACjE;AAEA,IAAI,gBAAgB,YAAY,KAAK,QAAQ,KAAK,CAAC,CAAC,GAAG;AACrD,OAAK,EAAE,KAAK,UAAQ,QAAQ,OAAO,MAAM,IAAI,MAAM,QAAQ,KAAK,IAAI,CAAC,CAAC;AACxE;","names":[]}
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  checkDeployedApp
3
- } from "../chunk-PABZALSD.js";
3
+ } from "../chunk-LBMFQLBS.js";
4
4
  import "../chunk-EI27JMS6.js";
5
5
  import "../chunk-RN4WPTBH.js";
6
6
  export {
@@ -33,8 +33,9 @@ export interface ConformanceOptions {
33
33
  operatorKey?: string;
34
34
  /** Id or exact name of the workspace the turns run in: the app's canary or smoke workspace, never a customer's. */
35
35
  workspace?: string;
36
- /** `digest` hashes a fresh nonce on the workspace computer; `file` has the computer save a file the app serves back. */
37
- computer?: ComputerProof;
36
+ /** `digest` hashes a fresh nonce on the workspace computer; `file` has the computer save a file the app serves back;
37
+ * `none` runs the plain turn only, for a check that asks exactly once (a post-serve first ask). */
38
+ computer?: ComputerProof | 'none';
38
39
  /** The computer turn's model. The plain turn keeps the app's own model, so the served model is still checked once. */
39
40
  computerModel?: string;
40
41
  /** Where the `file` proof is saved, relative to the workspace root. */
@@ -2,7 +2,7 @@ import "../chunk-KG2Y44XT.js";
2
2
  import {
3
3
  NATIVE_COMPLETION_RECEIPT_MAX_BYTES,
4
4
  observeNativeCompletion
5
- } from "../chunk-HES3IABJ.js";
5
+ } from "../chunk-JKYCXQFI.js";
6
6
  import {
7
7
  createFieldCrypto
8
8
  } from "../chunk-AWIQQEFP.js";
@@ -13,7 +13,7 @@ import "../chunk-VGS2NXLB.js";
13
13
  import {
14
14
  assistantRowIdForTurn,
15
15
  createAssistantDraftWriter
16
- } from "../chunk-5DAEU3CP.js";
16
+ } from "../chunk-SJKQUTGU.js";
17
17
  import "../chunk-2PCNHHN2.js";
18
18
  import "../chunk-YG66IHDU.js";
19
19
  import "../chunk-4YZKDWMB.js";
@@ -121,9 +121,9 @@ export declare function createPublicConsultation(options: PublicConsultationOpti
121
121
  executionBudget?: ChatTurnExecutionLimits;
122
122
  maxOutputTokens?: number;
123
123
  }) => Promise<{
124
- start?: undefined;
125
124
  status: 'unsupported';
126
125
  reason: string;
126
+ start?: undefined;
127
127
  } | {
128
128
  reason?: undefined;
129
129
  status: 'prepared';
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  createChatTurnRoutes,
3
3
  streamChatRouteAsSandboxEvents
4
- } from "../chunk-JSWBJBPM.js";
4
+ } from "../chunk-W5YQZEE4.js";
5
5
  import "../chunk-SBHFMDR7.js";
6
6
  import "../chunk-H6BRJU5M.js";
7
7
  import "../chunk-4DBHC63F.js";
@@ -11,7 +11,7 @@ import "../chunk-M4QITAQV.js";
11
11
  import "../chunk-JFBJ7MGK.js";
12
12
  import "../chunk-F4TUZYMX.js";
13
13
  import "../chunk-MH74DY2I.js";
14
- import "../chunk-5DAEU3CP.js";
14
+ import "../chunk-SJKQUTGU.js";
15
15
  import "../chunk-2PCNHHN2.js";
16
16
  import "../chunk-YG66IHDU.js";
17
17
  import "../chunk-4YZKDWMB.js";
@@ -34,7 +34,7 @@ import "../chunk-S5SRJJQG.js";
34
34
  import "../chunk-GD4ONMKJ.js";
35
35
  import "../chunk-UGWQLQDS.js";
36
36
  import "../chunk-R32MULDK.js";
37
- import "../chunk-PISTUUEZ.js";
37
+ import "../chunk-XCUT2I52.js";
38
38
  import "../chunk-D6UJEOZQ.js";
39
39
  import "../chunk-YYA2CVOY.js";
40
40
  import "../chunk-KSLTD4FI.js";
@@ -227,6 +227,7 @@ function publicationTools(publication, authorize) {
227
227
  {
228
228
  name: "knowledge_search",
229
229
  description: "Search published consultation knowledge.",
230
+ effect: "lookup",
230
231
  inputSchema: { type: "object", required: ["query"], properties: { query: { type: "string" } }, additionalProperties: false },
231
232
  run: async (args) => {
232
233
  await authorize();
@@ -236,6 +237,7 @@ function publicationTools(publication, authorize) {
236
237
  {
237
238
  name: "knowledge_read",
238
239
  description: "Read a published page by its exact citation id.",
240
+ effect: "lookup",
239
241
  inputSchema: { type: "object", required: ["pageId"], properties: { pageId: { type: "string" } }, additionalProperties: false },
240
242
  run: async (args) => {
241
243
  await authorize();
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/public-consultation/index.ts"],"sourcesContent":["import { searchKnowledge, type KnowledgeIndex, type KnowledgePage } from '@tangle-network/agent-knowledge'\nimport { createChatTurnRoutes, type ChatTurnExecutionLimits, type ChatTurnLock, type ChatTurnMessageStore, type ChatTurnRouteProducer } from '../chat-routes/turn-routes'\nimport { streamChatRouteAsSandboxEvents } from '../chat-routes/gateway-adapter'\nimport type { TurnEventStore } from '../stream/turn-buffer'\nimport type { McpToolDefinition } from '../tools/mcp-rpc'\n\nexport interface PublishedKnowledgePage {\n readonly id: string\n readonly title: string\n readonly text: string\n}\n\n/** A server-created publication. Every selected page's complete text is public. */\nexport interface KnowledgePublication {\n readonly id: string\n readonly revision: string\n readonly ownerId: string\n readonly systemPrompt: string\n read(pageId: string): PublishedKnowledgePage | null\n search(query: string): PublishedKnowledgePage[]\n}\n\n/** Select content at publication time, before any payer or model input exists. */\nexport function createKnowledgePublication(input: {\n id: string\n revision: string\n ownerId: string\n systemPrompt: string\n index: KnowledgeIndex\n pageIds: readonly string[]\n}): KnowledgePublication {\n for (const value of [input.id, input.revision, input.ownerId]) requireIdentity(value)\n const pages: KnowledgePage[] = []\n for (const id of new Set(input.pageIds)) {\n const matches = input.index.pages.filter(page => page.id === id)\n if (matches.length !== 1) throw new Error('Publication page must resolve exactly once')\n const page = matches[0]!\n // Owner metadata, paths, links and source records can refer to private resources.\n pages.push({ id: page.id, title: page.title, text: page.text, path: page.id,\n frontmatter: {}, sourceIds: [], tags: [], outLinks: [] })\n }\n const index: KnowledgeIndex = { root: '', generatedAt: '', sources: [], pages, graph: { nodes: [], edges: [] } }\n const publicPage = (page: KnowledgePage): PublishedKnowledgePage =>\n Object.freeze({ id: page.id, title: page.title, text: page.text })\n return Object.freeze({\n id: input.id, revision: input.revision, ownerId: input.ownerId, systemPrompt: input.systemPrompt,\n read: (id: string) => {\n const page = pages.find(candidate => candidate.id === id)\n return page ? publicPage(page) : null\n },\n search: (query: string) => searchKnowledge(index, query, { limit: 10 }).map(hit => publicPage(hit.page)),\n })\n}\n\n/** Authenticated server identity. Never construct this from model arguments or request JSON. */\nexport interface ConsultationConsumer {\n method: string\n consumerId: string\n keyId?: string\n ownerId?: string\n requestId: string\n threadId?: string\n}\n\nexport interface ConsultationAgent {\n id: string\n ownerId: string\n}\n\nexport interface ConsultationIdentity {\n readonly publicationId: string\n readonly publicationRevision: string\n readonly consumerId: string\n readonly paymentMethod: string\n readonly workspaceId: string\n readonly threadId: string\n}\n\nexport interface ConsultationExecutionControl {\n readonly identity: ConsultationIdentity\n readonly signal: AbortSignal\n readonly executionLimits?: Readonly<ChatTurnExecutionLimits>\n}\n\nexport type PreparedConsultationExecution =\n | { status: 'unsupported'; reason: string }\n | { status: 'prepared'; produce(input: ConsultationExecution): ChatTurnRouteProducer | Promise<ChatTurnRouteProducer> }\n\nexport interface ConsultationExecution extends ConsultationExecutionControl {\n readonly identity: ConsultationIdentity\n readonly systemPrompt: string\n readonly prompt: string\n readonly priorMessages: ReadonlyArray<{ role: string; content: string }>\n readonly tools: McpToolDefinition[]\n}\n\nexport interface PublicConsultationOptions {\n /** Resolve only deliberately published snapshots. Return null after revocation. */\n resolvePublication(agentId: string): Promise<KnowledgePublication | null>\n /** Payment authentication does not substitute for this admission decision. */\n allowConsumer(publication: KnowledgePublication, consumer: ConsultationConsumer): Promise<boolean>\n store: ChatTurnMessageStore\n turnStore: TurnEventStore\n /** Shared durable single-flight lock. Use createDurableTurnLock with thread scope. */\n turnLock: ChatTurnLock<void>\n /** Create or read the stored parent row. Return its actual persisted ownership. */\n ensureConversation(identity: ConsultationIdentity): Promise<{ workspaceId: string; threadId: string }>\n /** Prepare without compute. Refuse limits the isolated executor cannot enforce across all model and tool calls. */\n prepareExecution(input: ConsultationExecutionControl): Promise<PreparedConsultationExecution>\n}\n\ninterface GatewayConsultationContext {\n consumerId: string\n paymentMethod: string\n requestId: string\n threadId?: string\n keyInfo: { keyId: string; ownerId?: string } | null\n messages: Array<{ role: string; content: string }>\n}\n\n/** Compose gateway admission, scoped knowledge and the maintained persisted chat route. */\nexport function createPublicConsultation(options: PublicConsultationOptions) {\n if (typeof options.turnLock?.acquire !== 'function' || typeof options.turnLock.release !== 'function') {\n throw new Error('Public consultation requires a shared turn lock')\n }\n async function ownsConversation(identity: ConsultationIdentity) {\n const conversation = await options.ensureConversation(identity)\n return conversation?.workspaceId === identity.workspaceId && conversation.threadId === identity.threadId\n }\n async function resolve(agent: ConsultationAgent, consumer: ConsultationConsumer) {\n requireIdentity(consumer.consumerId)\n requireIdentity(consumer.method)\n requireIdentity(consumer.threadId)\n const publication = await options.resolvePublication(agent.id)\n if (!publication || publication.id !== agent.id || publication.ownerId !== agent.ownerId\n || await options.allowConsumer(publication, consumer) !== true) return null\n const workspaceId = await scopedId([publication.ownerId, publication.id, publication.revision, consumer.method, consumer.consumerId])\n const threadId = await scopedId([workspaceId, consumer.threadId!])\n const identity: ConsultationIdentity = Object.freeze({\n publicationId: publication.id, publicationRevision: publication.revision,\n consumerId: consumer.consumerId, paymentMethod: consumer.method, workspaceId, threadId,\n })\n return { publication, identity }\n }\n\n return {\n async authorizeConsumer(agent: ConsultationAgent, consumer: ConsultationConsumer) {\n const scope = await resolve(agent, consumer)\n return scope\n ? { allow: true as const }\n : { allow: false as const, reason: 'Consultation access denied', code: 'consultation_forbidden' }\n },\n async readKnowledge(agent: ConsultationAgent, consumer: ConsultationConsumer, pageId: string) {\n const scope = await resolve(agent, consumer)\n if (!scope) throw new Error('Consultation access denied')\n return scope.publication.read(pageId)\n },\n async readHistory(agent: ConsultationAgent, consumer: ConsultationConsumer) {\n const scope = await resolve(agent, consumer)\n if (!scope) throw new Error('Consultation access denied')\n if (!await ownsConversation(scope.identity)) throw new Error('Consultation conversation conflict')\n return (await options.store.listMessages(scope.identity.threadId))\n .map(({ role, content }) => ({ role, content }))\n },\n async getSandbox(agent: ConsultationAgent, context?: GatewayConsultationContext) {\n if (!context) throw new Error('Authenticated consultation identity is required')\n const consumer: ConsultationConsumer = {\n consumerId: context.consumerId, method: context.paymentMethod,\n requestId: context.requestId, threadId: context.threadId,\n keyId: context.keyInfo?.keyId, ownerId: context.keyInfo?.ownerId,\n }\n const scope = await resolve(agent, consumer)\n if (!scope) throw new Error('Consultation access denied')\n // Client-supplied history and owner system prompts never enter this producer.\n const prompt = context.messages.filter(message => message.role === 'user').at(-1)?.content\n if (!prompt) throw new Error('Consultation requires a user message')\n type PromptOptions = { signal?: AbortSignal; executionBudget?: ChatTurnExecutionLimits; maxOutputTokens?: number }\n const prepare = async (streamOptions?: PromptOptions) => {\n const signal = streamOptions?.signal ?? new AbortController().signal\n signal.throwIfAborted()\n const supplied = streamOptions?.executionBudget\n const executionLimits = supplied || streamOptions?.maxOutputTokens !== undefined\n ? Object.freeze({ ...supplied, ...(streamOptions?.maxOutputTokens !== undefined\n ? { maxOutputTokens: Math.min(streamOptions.maxOutputTokens, supplied?.maxOutputTokens ?? Infinity) } : {}) })\n : undefined\n if (executionLimits && Object.values(executionLimits).some(value => typeof value !== 'number' || !Number.isFinite(value) || value < 0)) {\n return { status: 'unsupported' as const, reason: 'Invalid consultation execution limits' }\n }\n const control = Object.freeze({ identity: scope.identity, signal, executionLimits })\n const prepared = await options.prepareExecution(control)\n signal.throwIfAborted()\n if (prepared?.status !== 'prepared' || typeof prepared.produce !== 'function') {\n return { status: 'unsupported' as const, reason: prepared?.status === 'unsupported'\n ? prepared.reason : 'Invalid consultation execution preparation' }\n }\n let started = false\n const start = () => {\n signal.throwIfAborted()\n if (started) throw new Error('Consultation execution already started')\n started = true\n const routes = createChatTurnRoutes({\n projectId: 'public-consultation', store: options.store, turnStore: options.turnStore, turnLock: options.turnLock,\n authorize: async ({ intent, body }) => {\n const current = await resolve(agent, consumer)\n if (intent !== 'turn' || !current\n || current.identity.workspaceId !== scope.identity.workspaceId\n || body?.workspaceId !== scope.identity.workspaceId || body.threadId !== scope.identity.threadId) {\n return { ok: false, response: Response.json({ error: 'Consultation access denied' }, { status: 403 }) }\n }\n if (!await ownsConversation(scope.identity)) {\n return { ok: false, response: Response.json({ error: 'Consultation conversation conflict' }, { status: 403 }) }\n }\n return { ok: true, tenantId: scope.identity.workspaceId,\n userId: scope.identity.consumerId, context: undefined }\n },\n produce: args => {\n signal.throwIfAborted()\n return prepared.produce({\n ...control,\n identity: scope.identity, systemPrompt: scope.publication.systemPrompt, prompt,\n priorMessages: args.priorMessages.map(({ role, content }) => ({ role, content })),\n tools: publicationTools(scope.publication, async () => {\n signal.throwIfAborted()\n const current = await resolve(agent, consumer)\n signal.throwIfAborted()\n if (!current || current.identity.workspaceId !== scope.identity.workspaceId) {\n throw new Error('Consultation access denied')\n }\n }),\n })\n },\n })\n return streamChatRouteAsSandboxEvents({\n routes, request: new Request('https://consultation.invalid/internal'),\n payload: { workspaceId: scope.identity.workspaceId, threadId: scope.identity.threadId,\n content: prompt, turnId: consumer.requestId }, signal, executionLimits,\n })\n }\n return { status: 'prepared' as const, start }\n }\n return {\n prepareBudgetedPrompt: (_message: string, streamOptions: PromptOptions) => prepare(streamOptions),\n streamPrompt: async function* (_message: string, streamOptions?: PromptOptions) {\n const prepared = await prepare(streamOptions)\n if (prepared.status !== 'prepared') throw new Error(prepared.reason)\n yield* prepared.start()\n },\n }\n },\n }\n}\n\nfunction publicationTools(publication: KnowledgePublication, authorize: () => Promise<void>): McpToolDefinition[] {\n return [\n { name: 'knowledge_search', description: 'Search published consultation knowledge.',\n inputSchema: { type: 'object', required: ['query'], properties: { query: { type: 'string' } }, additionalProperties: false },\n run: async args => { await authorize(); return publication.search(singleArgument(args, 'query')) } },\n { name: 'knowledge_read', description: 'Read a published page by its exact citation id.',\n inputSchema: { type: 'object', required: ['pageId'], properties: { pageId: { type: 'string' } }, additionalProperties: false },\n run: async args => { await authorize(); return publication.read(singleArgument(args, 'pageId')) } },\n ]\n}\n\nfunction singleArgument(args: Record<string, unknown>, name: string): string {\n const value = args[name]\n if (Object.keys(args).length !== 1 || typeof value !== 'string' || !value.trim() || value.length > 8192) {\n throw new Error('Invalid published knowledge arguments')\n }\n return value\n}\n\nfunction requireIdentity(value: unknown): asserts value is string {\n if (typeof value !== 'string' || !value.trim() || value.length > 512) throw new Error('Invalid consultation identity')\n}\n\nasync function scopedId(parts: string[]): Promise<string> {\n const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(JSON.stringify(parts)))\n return `consultation:${Array.from(new Uint8Array(digest), byte => byte.toString(16).padStart(2, '0')).join('')}`\n}\n"],"mappings":"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","names":["page"]}
1
+ {"version":3,"sources":["../../src/public-consultation/index.ts"],"sourcesContent":["import { searchKnowledge, type KnowledgeIndex, type KnowledgePage } from '@tangle-network/agent-knowledge'\nimport { createChatTurnRoutes, type ChatTurnExecutionLimits, type ChatTurnLock, type ChatTurnMessageStore, type ChatTurnRouteProducer } from '../chat-routes/turn-routes'\nimport { streamChatRouteAsSandboxEvents } from '../chat-routes/gateway-adapter'\nimport type { TurnEventStore } from '../stream/turn-buffer'\nimport type { McpToolDefinition } from '../tools/mcp-rpc'\nimport type { RouterTurnTool } from '../runtime/router-turn'\n\nexport interface PublishedKnowledgePage {\n readonly id: string\n readonly title: string\n readonly text: string\n}\n\n/** A server-created publication. Every selected page's complete text is public. */\nexport interface KnowledgePublication {\n readonly id: string\n readonly revision: string\n readonly ownerId: string\n readonly systemPrompt: string\n read(pageId: string): PublishedKnowledgePage | null\n search(query: string): PublishedKnowledgePage[]\n}\n\n/** Select content at publication time, before any payer or model input exists. */\nexport function createKnowledgePublication(input: {\n id: string\n revision: string\n ownerId: string\n systemPrompt: string\n index: KnowledgeIndex\n pageIds: readonly string[]\n}): KnowledgePublication {\n for (const value of [input.id, input.revision, input.ownerId]) requireIdentity(value)\n const pages: KnowledgePage[] = []\n for (const id of new Set(input.pageIds)) {\n const matches = input.index.pages.filter(page => page.id === id)\n if (matches.length !== 1) throw new Error('Publication page must resolve exactly once')\n const page = matches[0]!\n // Owner metadata, paths, links and source records can refer to private resources.\n pages.push({ id: page.id, title: page.title, text: page.text, path: page.id,\n frontmatter: {}, sourceIds: [], tags: [], outLinks: [] })\n }\n const index: KnowledgeIndex = { root: '', generatedAt: '', sources: [], pages, graph: { nodes: [], edges: [] } }\n const publicPage = (page: KnowledgePage): PublishedKnowledgePage =>\n Object.freeze({ id: page.id, title: page.title, text: page.text })\n return Object.freeze({\n id: input.id, revision: input.revision, ownerId: input.ownerId, systemPrompt: input.systemPrompt,\n read: (id: string) => {\n const page = pages.find(candidate => candidate.id === id)\n return page ? publicPage(page) : null\n },\n search: (query: string) => searchKnowledge(index, query, { limit: 10 }).map(hit => publicPage(hit.page)),\n })\n}\n\n/** Authenticated server identity. Never construct this from model arguments or request JSON. */\nexport interface ConsultationConsumer {\n method: string\n consumerId: string\n keyId?: string\n ownerId?: string\n requestId: string\n threadId?: string\n}\n\nexport interface ConsultationAgent {\n id: string\n ownerId: string\n}\n\nexport interface ConsultationIdentity {\n readonly publicationId: string\n readonly publicationRevision: string\n readonly consumerId: string\n readonly paymentMethod: string\n readonly workspaceId: string\n readonly threadId: string\n}\n\nexport interface ConsultationExecutionControl {\n readonly identity: ConsultationIdentity\n readonly signal: AbortSignal\n readonly executionLimits?: Readonly<ChatTurnExecutionLimits>\n}\n\nexport type PreparedConsultationExecution =\n | { status: 'unsupported'; reason: string }\n | { status: 'prepared'; produce(input: ConsultationExecution): ChatTurnRouteProducer | Promise<ChatTurnRouteProducer> }\n\nexport interface ConsultationExecution extends ConsultationExecutionControl {\n readonly identity: ConsultationIdentity\n readonly systemPrompt: string\n readonly prompt: string\n readonly priorMessages: ReadonlyArray<{ role: string; content: string }>\n readonly tools: McpToolDefinition[]\n}\n\nexport interface PublicConsultationOptions {\n /** Resolve only deliberately published snapshots. Return null after revocation. */\n resolvePublication(agentId: string): Promise<KnowledgePublication | null>\n /** Payment authentication does not substitute for this admission decision. */\n allowConsumer(publication: KnowledgePublication, consumer: ConsultationConsumer): Promise<boolean>\n store: ChatTurnMessageStore\n turnStore: TurnEventStore\n /** Shared durable single-flight lock. Use createDurableTurnLock with thread scope. */\n turnLock: ChatTurnLock<void>\n /** Create or read the stored parent row. Return its actual persisted ownership. */\n ensureConversation(identity: ConsultationIdentity): Promise<{ workspaceId: string; threadId: string }>\n /** Prepare without compute. Refuse limits the isolated executor cannot enforce across all model and tool calls. */\n prepareExecution(input: ConsultationExecutionControl): Promise<PreparedConsultationExecution>\n}\n\ninterface GatewayConsultationContext {\n consumerId: string\n paymentMethod: string\n requestId: string\n threadId?: string\n keyInfo: { keyId: string; ownerId?: string } | null\n messages: Array<{ role: string; content: string }>\n}\n\n/** Compose gateway admission, scoped knowledge and the maintained persisted chat route. */\nexport function createPublicConsultation(options: PublicConsultationOptions) {\n if (typeof options.turnLock?.acquire !== 'function' || typeof options.turnLock.release !== 'function') {\n throw new Error('Public consultation requires a shared turn lock')\n }\n async function ownsConversation(identity: ConsultationIdentity) {\n const conversation = await options.ensureConversation(identity)\n return conversation?.workspaceId === identity.workspaceId && conversation.threadId === identity.threadId\n }\n async function resolve(agent: ConsultationAgent, consumer: ConsultationConsumer) {\n requireIdentity(consumer.consumerId)\n requireIdentity(consumer.method)\n requireIdentity(consumer.threadId)\n const publication = await options.resolvePublication(agent.id)\n if (!publication || publication.id !== agent.id || publication.ownerId !== agent.ownerId\n || await options.allowConsumer(publication, consumer) !== true) return null\n const workspaceId = await scopedId([publication.ownerId, publication.id, publication.revision, consumer.method, consumer.consumerId])\n const threadId = await scopedId([workspaceId, consumer.threadId!])\n const identity: ConsultationIdentity = Object.freeze({\n publicationId: publication.id, publicationRevision: publication.revision,\n consumerId: consumer.consumerId, paymentMethod: consumer.method, workspaceId, threadId,\n })\n return { publication, identity }\n }\n\n return {\n async authorizeConsumer(agent: ConsultationAgent, consumer: ConsultationConsumer) {\n const scope = await resolve(agent, consumer)\n return scope\n ? { allow: true as const }\n : { allow: false as const, reason: 'Consultation access denied', code: 'consultation_forbidden' }\n },\n async readKnowledge(agent: ConsultationAgent, consumer: ConsultationConsumer, pageId: string) {\n const scope = await resolve(agent, consumer)\n if (!scope) throw new Error('Consultation access denied')\n return scope.publication.read(pageId)\n },\n async readHistory(agent: ConsultationAgent, consumer: ConsultationConsumer) {\n const scope = await resolve(agent, consumer)\n if (!scope) throw new Error('Consultation access denied')\n if (!await ownsConversation(scope.identity)) throw new Error('Consultation conversation conflict')\n return (await options.store.listMessages(scope.identity.threadId))\n .map(({ role, content }) => ({ role, content }))\n },\n async getSandbox(agent: ConsultationAgent, context?: GatewayConsultationContext) {\n if (!context) throw new Error('Authenticated consultation identity is required')\n const consumer: ConsultationConsumer = {\n consumerId: context.consumerId, method: context.paymentMethod,\n requestId: context.requestId, threadId: context.threadId,\n keyId: context.keyInfo?.keyId, ownerId: context.keyInfo?.ownerId,\n }\n const scope = await resolve(agent, consumer)\n if (!scope) throw new Error('Consultation access denied')\n // Client-supplied history and owner system prompts never enter this producer.\n const prompt = context.messages.filter(message => message.role === 'user').at(-1)?.content\n if (!prompt) throw new Error('Consultation requires a user message')\n type PromptOptions = { signal?: AbortSignal; executionBudget?: ChatTurnExecutionLimits; maxOutputTokens?: number }\n const prepare = async (streamOptions?: PromptOptions) => {\n const signal = streamOptions?.signal ?? new AbortController().signal\n signal.throwIfAborted()\n const supplied = streamOptions?.executionBudget\n const executionLimits = supplied || streamOptions?.maxOutputTokens !== undefined\n ? Object.freeze({ ...supplied, ...(streamOptions?.maxOutputTokens !== undefined\n ? { maxOutputTokens: Math.min(streamOptions.maxOutputTokens, supplied?.maxOutputTokens ?? Infinity) } : {}) })\n : undefined\n if (executionLimits && Object.values(executionLimits).some(value => typeof value !== 'number' || !Number.isFinite(value) || value < 0)) {\n return { status: 'unsupported' as const, reason: 'Invalid consultation execution limits' }\n }\n const control = Object.freeze({ identity: scope.identity, signal, executionLimits })\n const prepared = await options.prepareExecution(control)\n signal.throwIfAborted()\n if (prepared?.status !== 'prepared' || typeof prepared.produce !== 'function') {\n return { status: 'unsupported' as const, reason: prepared?.status === 'unsupported'\n ? prepared.reason : 'Invalid consultation execution preparation' }\n }\n let started = false\n const start = () => {\n signal.throwIfAborted()\n if (started) throw new Error('Consultation execution already started')\n started = true\n const routes = createChatTurnRoutes({\n projectId: 'public-consultation', store: options.store, turnStore: options.turnStore, turnLock: options.turnLock,\n authorize: async ({ intent, body }) => {\n const current = await resolve(agent, consumer)\n if (intent !== 'turn' || !current\n || current.identity.workspaceId !== scope.identity.workspaceId\n || body?.workspaceId !== scope.identity.workspaceId || body.threadId !== scope.identity.threadId) {\n return { ok: false, response: Response.json({ error: 'Consultation access denied' }, { status: 403 }) }\n }\n if (!await ownsConversation(scope.identity)) {\n return { ok: false, response: Response.json({ error: 'Consultation conversation conflict' }, { status: 403 }) }\n }\n return { ok: true, tenantId: scope.identity.workspaceId,\n userId: scope.identity.consumerId, context: undefined }\n },\n produce: args => {\n signal.throwIfAborted()\n return prepared.produce({\n ...control,\n identity: scope.identity, systemPrompt: scope.publication.systemPrompt, prompt,\n priorMessages: args.priorMessages.map(({ role, content }) => ({ role, content })),\n tools: publicationTools(scope.publication, async () => {\n signal.throwIfAborted()\n const current = await resolve(agent, consumer)\n signal.throwIfAborted()\n if (!current || current.identity.workspaceId !== scope.identity.workspaceId) {\n throw new Error('Consultation access denied')\n }\n }),\n })\n },\n })\n return streamChatRouteAsSandboxEvents({\n routes, request: new Request('https://consultation.invalid/internal'),\n payload: { workspaceId: scope.identity.workspaceId, threadId: scope.identity.threadId,\n content: prompt, turnId: consumer.requestId }, signal, executionLimits,\n })\n }\n return { status: 'prepared' as const, start }\n }\n return {\n prepareBudgetedPrompt: (_message: string, streamOptions: PromptOptions) => prepare(streamOptions),\n streamPrompt: async function* (_message: string, streamOptions?: PromptOptions) {\n const prepared = await prepare(streamOptions)\n if (prepared.status !== 'prepared') throw new Error(prepared.reason)\n yield* prepared.start()\n },\n }\n },\n }\n}\n\nfunction publicationTools(publication: KnowledgePublication, authorize: () => Promise<void>): Array<McpToolDefinition & Pick<RouterTurnTool, 'effect'>> {\n return [\n { name: 'knowledge_search', description: 'Search published consultation knowledge.', effect: 'lookup',\n inputSchema: { type: 'object', required: ['query'], properties: { query: { type: 'string' } }, additionalProperties: false },\n run: async args => { await authorize(); return publication.search(singleArgument(args, 'query')) } },\n { name: 'knowledge_read', description: 'Read a published page by its exact citation id.', effect: 'lookup',\n inputSchema: { type: 'object', required: ['pageId'], properties: { pageId: { type: 'string' } }, additionalProperties: false },\n run: async args => { await authorize(); return publication.read(singleArgument(args, 'pageId')) } },\n ]\n}\n\nfunction singleArgument(args: Record<string, unknown>, name: string): string {\n const value = args[name]\n if (Object.keys(args).length !== 1 || typeof value !== 'string' || !value.trim() || value.length > 8192) {\n throw new Error('Invalid published knowledge arguments')\n }\n return value\n}\n\nfunction requireIdentity(value: unknown): asserts value is string {\n if (typeof value !== 'string' || !value.trim() || value.length > 512) throw new Error('Invalid consultation identity')\n}\n\nasync function scopedId(parts: string[]): Promise<string> {\n const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(JSON.stringify(parts)))\n return `consultation:${Array.from(new Uint8Array(digest), byte => byte.toString(16).padStart(2, '0')).join('')}`\n}\n"],"mappings":"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","names":["page"]}
@@ -2,7 +2,7 @@ import {
2
2
  ProtectedModelSettlementError,
3
3
  createRouterProtectedModelPort,
4
4
  runProtectedRouterTurn
5
- } from "../chunk-AFMLLZWU.js";
5
+ } from "../chunk-GWATTXFR.js";
6
6
  import {
7
7
  DURABLE_HOP_BUDGET_MS,
8
8
  asksForLanguage,
@@ -13,6 +13,7 @@ import {
13
13
  createOpenAICompatStreamTurn,
14
14
  createOpenAIResponsesTurn,
15
15
  isOpenAIResponsesModel,
16
+ narratesBefore,
16
17
  perTurnPrefixBytes,
17
18
  placeRouterTurn,
18
19
  replyLanguageInstruction,
@@ -26,7 +27,7 @@ import {
26
27
  turnKnowledgeInstructions,
27
28
  workspaceKnowledgeForTurn,
28
29
  workspaceTurnCheckpoints
29
- } from "../chunk-PISTUUEZ.js";
30
+ } from "../chunk-XCUT2I52.js";
30
31
  import {
31
32
  DEFAULT_TANGLE_BILLING_ENFORCEMENT_ENV_VAR,
32
33
  DEFAULT_TANGLE_ROUTER_BASE_URL,
@@ -193,6 +194,7 @@ export {
193
194
  isTangleBillingEnforcementDisabled,
194
195
  isTangleExecutionKeyError,
195
196
  mergeSurfaceOverlay,
197
+ narratesBefore,
196
198
  normalizeModelId,
197
199
  perTurnPrefixBytes,
198
200
  placeRouterTurn,
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/runtime/certified-delivery.ts","../../src/runtime/surface-profile.ts"],"sourcesContent":["/**\n * Application profile composition using Runtime's certified-guidance source.\n *\n * The shell adapts the prompt source to the application's resolved profile;\n * Runtime owns pulling, cache lifetime, concurrent refresh and retained guidance.\n * Only prompt-compatible guidance is folded here. Tool definitions, execution\n * permissions, MCP servers and files are not installed from certified material.\n * The complete profile remains available through `current()` for inspection and\n * the product's separately authorized materialization path.\n */\nimport {\n createCertifiedPromptSource,\n type CertifiedProfile,\n type CertifiedPromptSourceOptions,\n} from '@tangle-network/agent-runtime/intelligence'\nimport type { ResolvedAgentProfile } from './agent'\n\n/** Pull coordinates, refresh cadence and timeout owned by the shared source. */\nexport type CertifiedDeliveryConfig = CertifiedPromptSourceOptions\n\n/** Adapt certified prompt guidance without granting execution authority. */\nexport interface CertifiedDelivery {\n /** Refresh on the source's cadence and compose the current prompt guidance.\n * Other resolved profile fields pass through unchanged. */\n composeProfile(base: ResolvedAgentProfile): Promise<ResolvedAgentProfile>\n /** Force a pull now, coalescing with an in-flight pull. Best-effort; not a\n * post-activation revision barrier or a permission-revocation protocol. */\n refresh(): Promise<void>\n /** Last successfully pulled profile, or null before a successful pull. */\n current(): CertifiedProfile | null\n}\n\nexport function createCertifiedDelivery(config: CertifiedDeliveryConfig): CertifiedDelivery {\n const source = createCertifiedPromptSource(config)\n return {\n async composeProfile(base) {\n return { ...base, systemPrompt: await source.compose(base.systemPrompt) }\n },\n refresh: () => source.refresh({ force: true }),\n current: source.current,\n }\n}\n","/**\n * Surface-scoped profile overlay — the seam letting any product page (a\n * sequence editor, a brief composer, a dataset view) add MCP servers, a prompt\n * addendum, and permission tightening to the workspace agent profile for turns\n * initiated FROM that surface, without the chat orchestrator knowing any\n * surface's specifics. The orchestrator resolves `(kind, ctx)` through a\n * registry the REQUEST HANDLER constructs per request (construction is a Map\n * build — cheap) and merges the result into the base profile it was about to\n * send to the sandbox. Per-request construction is the trust mechanism, not an\n * optimization target: each `build()` closes over server-trusted request state\n * (env bindings, secrets, the AUTHENTICATED user/workspace), which on Workers\n * exists only per request — a startup-built registry would force identity\n * through the untrusted client `ctx`.\n *\n * SECURITY INVARIANT: the surface `kind` and the ids inside `ctx` arrive on\n * the client request and are pure ROUTING data — never trusted content, never\n * identity. Identity comes from the closure (see above). The registered\n * `build()` runs server-side only: it validates the routing ids against the\n * product's access control, then mints its own URLs from server configuration\n * (`buildHttpMcpServer` in ../tools). A client can therefore never inject an\n * arbitrary MCP url, header, or credential into the agent profile: the\n * overlay's `mcp` values are typed as {@link SurfaceMcpServer} (= the\n * server-built `AppToolMcpServer` entry shape), and only build() constructs\n * them.\n *\n * The credential itself never appears in the overlay. Since the tagged-config\n * contract (`agent-interface` 0.38.0) the `Authorization` header is a\n * `secret-ref` naming a box-environment variable, which the sandbox resolves\n * privately; `build()` supplies that key NAME from server configuration and the\n * product writes the value through `SandboxRuntimeConfig.env` at creation or\n * refreshes it through `SandboxRuntimeConfig.runtimeEnv` before retained-box\n * bootstrap. The value remains workspace-scoped because every member and turn\n * shares the box; runtime renewal does not create a per-user secret channel.\n */\n\nimport type { AppToolMcpServer } from '../tools/mcp'\n\n/** Sandbox permission posture values, ranked deny > ask > allow for merging. */\nexport type SurfacePermissionValue = 'allow' | 'ask' | 'deny'\n\n/** The only MCP entry shape an overlay may carry: the server-built bridge\n * entry from ../tools/mcp (transport, url, headers, and capability token all\n * assembled server-side). The alias exists so overlay authors reach for the\n * builders in ../tools rather than hand-rolling `{ url: ctx.url }` shapes\n * that would let request data become a dialable endpoint. */\nexport type SurfaceMcpServer = AppToolMcpServer\n\n/** What one surface contributes to the agent profile for a single turn. */\nexport interface SurfaceOverlay {\n /** MCP servers to mount for this turn, keyed by tool-routing name. Names\n * must not collide with the base profile's — see {@link mergeSurfaceOverlay}. */\n mcp?: Record<string, SurfaceMcpServer>\n /** Appended to the base system-prompt addendum with a blank-line separator. */\n promptAddendum?: string\n /** Per-key posture the surface wants for its turns. Merging is monotone\n * fail-closed: the stricter of base/overlay wins, so a surface can tighten\n * the workspace posture but never relax it. */\n permissions?: Record<string, SurfacePermissionValue>\n}\n\n/**\n * One registered surface kind. `TCtx` is the shape build() expects — a CLAIM\n * about the client payload, not a guarantee: the registry hands build() the\n * request's `ctx` unvalidated, so build() must treat every field as an\n * untrusted id (resolve it through access control that throws on a bad or\n * foreign id) before minting anything from it.\n */\nexport interface SurfaceKindDefinition<TCtx> {\n kind: string\n build: (ctx: TCtx) => SurfaceOverlay | Promise<SurfaceOverlay>\n}\n\n/** The variance-erased form a registry accepts (`build` is contravariant in\n * `TCtx`, so every concrete definition is assignable to this). */\nexport type AnySurfaceKind = SurfaceKindDefinition<never>\n\n/**\n * Declare one surface kind. The `kind` string is the client-visible routing\n * key (e.g. `'sequences'`); `build` is the server-side factory that turns a\n * validated ctx into the overlay for one turn.\n */\nexport function defineSurfaceKind<TCtx>(opts: {\n kind: string\n build: (ctx: TCtx) => SurfaceOverlay | Promise<SurfaceOverlay>\n}): SurfaceKindDefinition<TCtx> {\n if (typeof opts.kind !== 'string' || opts.kind.length === 0 || /\\s/.test(opts.kind)) {\n throw new Error(`surface kind must be a non-empty string without whitespace (got ${JSON.stringify(opts.kind)})`)\n }\n if (typeof opts.build !== 'function') {\n throw new Error(`surface kind '${opts.kind}' requires a build function`)\n }\n return { kind: opts.kind, build: opts.build }\n}\n\n/** Resolve and build the overlay for a given surface kind within a turn context */\nexport interface SurfaceRegistry {\n /** Build the overlay for one turn. Throws on an unknown kind — an unknown\n * surface is a routing bug (client and server registries drifted), and\n * silently returning an empty overlay would strip the surface's tools from\n * the turn with no signal anywhere. Build errors propagate unwrapped. */\n resolve(kind: string, ctx: unknown): Promise<SurfaceOverlay>\n}\n\n/**\n * Assemble the product's surface registry from its registered kinds. Duplicate\n * kinds throw at construction: two builders behind one routing key would make\n * the mounted toolset depend on registration order.\n */\nexport function createSurfaceRegistry(kinds: readonly AnySurfaceKind[]): SurfaceRegistry {\n const byKind = new Map<string, AnySurfaceKind>()\n for (const definition of kinds) {\n if (byKind.has(definition.kind)) {\n throw new Error(`duplicate surface kind '${definition.kind}' — each kind must be registered exactly once`)\n }\n byKind.set(definition.kind, definition)\n }\n\n return {\n async resolve(kind, ctx) {\n const definition = byKind.get(kind)\n if (!definition) {\n const known = [...byKind.keys()].join(', ') || '(none)'\n throw new Error(\n `unknown surface kind '${kind}' — registered kinds: ${known}. ` +\n 'An unknown surface is a routing bug: register the kind via defineSurfaceKind before clients can reference it.',\n )\n }\n // The trust boundary where static ctx typing ends: the request payload is\n // handed to build() as-is, and build() validates it (see SurfaceKindDefinition).\n const overlay = await definition.build(ctx as never)\n assertSurfaceOverlay(overlay, `surface kind '${kind}'`)\n return overlay\n },\n }\n}\n\n/** Base-profile slice the merge reads/writes. Real callers pass their full\n * profile object; every field outside this slice passes through untouched. */\nexport interface SurfaceMergeBase {\n mcp?: Record<string, unknown>\n systemPromptAddendum?: string\n permissions?: Record<string, SurfacePermissionValue>\n}\n\nconst PERMISSION_SEVERITY: Record<SurfacePermissionValue, number> = { allow: 0, ask: 1, deny: 2 }\n\n/**\n * Merge one surface overlay into a base profile, returning a new object\n * (the base is never mutated; untouched nested records are shared by\n * reference).\n *\n * - `mcp`: overlay servers are added under their own names. A name already\n * present on the base THROWS — a collision is two servers claiming one\n * routing name, and renaming either silently would corrupt tool routing for\n * whichever caller expected the original binding.\n * - `systemPromptAddendum`: the overlay's `promptAddendum` appends after a\n * blank-line separator (no separator when the base has no addendum).\n * - `permissions`: per key the STRICTER value wins (deny > ask > allow). A\n * surface can tighten the base posture for its turns; a base 'deny' survives\n * any overlay.\n */\nexport function mergeSurfaceOverlay<TBase extends SurfaceMergeBase>(\n base: TBase,\n overlay: SurfaceOverlay,\n): TBase & SurfaceMergeBase {\n assertSurfaceOverlay(overlay, 'surface overlay')\n const merged: SurfaceMergeBase = { ...base }\n\n if (overlay.mcp && Object.keys(overlay.mcp).length > 0) {\n const baseMcp = base.mcp ?? {}\n const collisions = Object.keys(overlay.mcp).filter((name) => name in baseMcp)\n if (collisions.length > 0) {\n throw new Error(\n `surface overlay MCP name collision: ${collisions.map((n) => `'${n}'`).join(', ')} already exist on the base profile. ` +\n 'Two servers cannot claim one name — give the surface server a distinct name.',\n )\n }\n merged.mcp = { ...baseMcp, ...overlay.mcp }\n }\n\n if (overlay.promptAddendum !== undefined) {\n merged.systemPromptAddendum = base.systemPromptAddendum\n ? `${base.systemPromptAddendum}\\n\\n${overlay.promptAddendum}`\n : overlay.promptAddendum\n }\n\n if (overlay.permissions && Object.keys(overlay.permissions).length > 0) {\n const permissions: Record<string, SurfacePermissionValue> = { ...(base.permissions ?? {}) }\n for (const [key, value] of Object.entries(overlay.permissions)) {\n const existing = permissions[key]\n permissions[key] =\n existing === undefined || PERMISSION_SEVERITY[value] > PERMISSION_SEVERITY[existing] ? value : existing\n }\n merged.permissions = permissions\n }\n\n // merged began as a shallow copy of base; only the three slice fields were\n // replaced, so the intersection type is the true shape.\n return merged as TBase & SurfaceMergeBase\n}\n\n/** Reject overlays a build() (or hand-rolled caller) malformed, with the exact\n * field named: a relative MCP url, a blank addendum, or an off-vocabulary\n * permission would otherwise surface only as an opaque sandbox failure. */\nfunction assertSurfaceOverlay(overlay: SurfaceOverlay, label: string): void {\n if (overlay.promptAddendum !== undefined) {\n if (typeof overlay.promptAddendum !== 'string' || overlay.promptAddendum.trim().length === 0) {\n throw new Error(`${label}: promptAddendum must be a non-blank string when provided`)\n }\n }\n if (overlay.mcp !== undefined) {\n for (const [name, server] of Object.entries(overlay.mcp)) {\n if (name.trim().length === 0) throw new Error(`${label}: MCP server names must be non-empty`)\n if (server.transport !== 'http') {\n throw new Error(`${label}: MCP server '${name}' must use transport 'http' (got ${JSON.stringify((server as { transport?: unknown }).transport)})`)\n }\n let parsed: URL\n try {\n parsed = new URL(server.url)\n } catch {\n throw new Error(`${label}: MCP server '${name}' url must be an absolute URL (got ${JSON.stringify(server.url)})`)\n }\n if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n throw new Error(`${label}: MCP server '${name}' url must be http(s) (got ${JSON.stringify(server.url)})`)\n }\n }\n }\n if (overlay.permissions !== undefined) {\n for (const [key, value] of Object.entries(overlay.permissions)) {\n if (!(value in PERMISSION_SEVERITY)) {\n throw new Error(`${label}: permission '${key}' must be 'allow' | 'ask' | 'deny' (got ${JSON.stringify(value)})`)\n }\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA;AAAA,EACE;AAAA,OAGK;AAkBA,SAAS,wBAAwB,QAAoD;AAC1F,QAAM,SAAS,4BAA4B,MAAM;AACjD,SAAO;AAAA,IACL,MAAM,eAAe,MAAM;AACzB,aAAO,EAAE,GAAG,MAAM,cAAc,MAAM,OAAO,QAAQ,KAAK,YAAY,EAAE;AAAA,IAC1E;AAAA,IACA,SAAS,MAAM,OAAO,QAAQ,EAAE,OAAO,KAAK,CAAC;AAAA,IAC7C,SAAS,OAAO;AAAA,EAClB;AACF;;;ACwCO,SAAS,kBAAwB,MAGR;AAC9B,MAAI,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,WAAW,KAAK,KAAK,KAAK,KAAK,IAAI,GAAG;AACnF,UAAM,IAAI,MAAM,mEAAmE,KAAK,UAAU,KAAK,IAAI,CAAC,GAAG;AAAA,EACjH;AACA,MAAI,OAAO,KAAK,UAAU,YAAY;AACpC,UAAM,IAAI,MAAM,iBAAiB,KAAK,IAAI,6BAA6B;AAAA,EACzE;AACA,SAAO,EAAE,MAAM,KAAK,MAAM,OAAO,KAAK,MAAM;AAC9C;AAgBO,SAAS,sBAAsB,OAAmD;AACvF,QAAM,SAAS,oBAAI,IAA4B;AAC/C,aAAW,cAAc,OAAO;AAC9B,QAAI,OAAO,IAAI,WAAW,IAAI,GAAG;AAC/B,YAAM,IAAI,MAAM,2BAA2B,WAAW,IAAI,oDAA+C;AAAA,IAC3G;AACA,WAAO,IAAI,WAAW,MAAM,UAAU;AAAA,EACxC;AAEA,SAAO;AAAA,IACL,MAAM,QAAQ,MAAM,KAAK;AACvB,YAAM,aAAa,OAAO,IAAI,IAAI;AAClC,UAAI,CAAC,YAAY;AACf,cAAM,QAAQ,CAAC,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,IAAI,KAAK;AAC/C,cAAM,IAAI;AAAA,UACR,yBAAyB,IAAI,8BAAyB,KAAK;AAAA,QAE7D;AAAA,MACF;AAGA,YAAM,UAAU,MAAM,WAAW,MAAM,GAAY;AACnD,2BAAqB,SAAS,iBAAiB,IAAI,GAAG;AACtD,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAUA,IAAM,sBAA8D,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,EAAE;AAiBzF,SAAS,oBACd,MACA,SAC0B;AAC1B,uBAAqB,SAAS,iBAAiB;AAC/C,QAAM,SAA2B,EAAE,GAAG,KAAK;AAE3C,MAAI,QAAQ,OAAO,OAAO,KAAK,QAAQ,GAAG,EAAE,SAAS,GAAG;AACtD,UAAM,UAAU,KAAK,OAAO,CAAC;AAC7B,UAAM,aAAa,OAAO,KAAK,QAAQ,GAAG,EAAE,OAAO,CAAC,SAAS,QAAQ,OAAO;AAC5E,QAAI,WAAW,SAAS,GAAG;AACzB,YAAM,IAAI;AAAA,QACR,uCAAuC,WAAW,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC;AAAA,MAEnF;AAAA,IACF;AACA,WAAO,MAAM,EAAE,GAAG,SAAS,GAAG,QAAQ,IAAI;AAAA,EAC5C;AAEA,MAAI,QAAQ,mBAAmB,QAAW;AACxC,WAAO,uBAAuB,KAAK,uBAC/B,GAAG,KAAK,oBAAoB;AAAA;AAAA,EAAO,QAAQ,cAAc,KACzD,QAAQ;AAAA,EACd;AAEA,MAAI,QAAQ,eAAe,OAAO,KAAK,QAAQ,WAAW,EAAE,SAAS,GAAG;AACtE,UAAM,cAAsD,EAAE,GAAI,KAAK,eAAe,CAAC,EAAG;AAC1F,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,WAAW,GAAG;AAC9D,YAAM,WAAW,YAAY,GAAG;AAChC,kBAAY,GAAG,IACb,aAAa,UAAa,oBAAoB,KAAK,IAAI,oBAAoB,QAAQ,IAAI,QAAQ;AAAA,IACnG;AACA,WAAO,cAAc;AAAA,EACvB;AAIA,SAAO;AACT;AAKA,SAAS,qBAAqB,SAAyB,OAAqB;AAC1E,MAAI,QAAQ,mBAAmB,QAAW;AACxC,QAAI,OAAO,QAAQ,mBAAmB,YAAY,QAAQ,eAAe,KAAK,EAAE,WAAW,GAAG;AAC5F,YAAM,IAAI,MAAM,GAAG,KAAK,2DAA2D;AAAA,IACrF;AAAA,EACF;AACA,MAAI,QAAQ,QAAQ,QAAW;AAC7B,eAAW,CAAC,MAAM,MAAM,KAAK,OAAO,QAAQ,QAAQ,GAAG,GAAG;AACxD,UAAI,KAAK,KAAK,EAAE,WAAW,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,sCAAsC;AAC5F,UAAI,OAAO,cAAc,QAAQ;AAC/B,cAAM,IAAI,MAAM,GAAG,KAAK,iBAAiB,IAAI,oCAAoC,KAAK,UAAW,OAAmC,SAAS,CAAC,GAAG;AAAA,MACnJ;AACA,UAAI;AACJ,UAAI;AACF,iBAAS,IAAI,IAAI,OAAO,GAAG;AAAA,MAC7B,QAAQ;AACN,cAAM,IAAI,MAAM,GAAG,KAAK,iBAAiB,IAAI,sCAAsC,KAAK,UAAU,OAAO,GAAG,CAAC,GAAG;AAAA,MAClH;AACA,UAAI,OAAO,aAAa,WAAW,OAAO,aAAa,UAAU;AAC/D,cAAM,IAAI,MAAM,GAAG,KAAK,iBAAiB,IAAI,8BAA8B,KAAK,UAAU,OAAO,GAAG,CAAC,GAAG;AAAA,MAC1G;AAAA,IACF;AAAA,EACF;AACA,MAAI,QAAQ,gBAAgB,QAAW;AACrC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,WAAW,GAAG;AAC9D,UAAI,EAAE,SAAS,sBAAsB;AACnC,cAAM,IAAI,MAAM,GAAG,KAAK,iBAAiB,GAAG,2CAA2C,KAAK,UAAU,KAAK,CAAC,GAAG;AAAA,MACjH;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
1
+ {"version":3,"sources":["../../src/runtime/certified-delivery.ts","../../src/runtime/surface-profile.ts"],"sourcesContent":["/**\n * Application profile composition using Runtime's certified-guidance source.\n *\n * The shell adapts the prompt source to the application's resolved profile;\n * Runtime owns pulling, cache lifetime, concurrent refresh and retained guidance.\n * Only prompt-compatible guidance is folded here. Tool definitions, execution\n * permissions, MCP servers and files are not installed from certified material.\n * The complete profile remains available through `current()` for inspection and\n * the product's separately authorized materialization path.\n */\nimport {\n createCertifiedPromptSource,\n type CertifiedProfile,\n type CertifiedPromptSourceOptions,\n} from '@tangle-network/agent-runtime/intelligence'\nimport type { ResolvedAgentProfile } from './agent'\n\n/** Pull coordinates, refresh cadence and timeout owned by the shared source. */\nexport type CertifiedDeliveryConfig = CertifiedPromptSourceOptions\n\n/** Adapt certified prompt guidance without granting execution authority. */\nexport interface CertifiedDelivery {\n /** Refresh on the source's cadence and compose the current prompt guidance.\n * Other resolved profile fields pass through unchanged. */\n composeProfile(base: ResolvedAgentProfile): Promise<ResolvedAgentProfile>\n /** Force a pull now, coalescing with an in-flight pull. Best-effort; not a\n * post-activation revision barrier or a permission-revocation protocol. */\n refresh(): Promise<void>\n /** Last successfully pulled profile, or null before a successful pull. */\n current(): CertifiedProfile | null\n}\n\nexport function createCertifiedDelivery(config: CertifiedDeliveryConfig): CertifiedDelivery {\n const source = createCertifiedPromptSource(config)\n return {\n async composeProfile(base) {\n return { ...base, systemPrompt: await source.compose(base.systemPrompt) }\n },\n refresh: () => source.refresh({ force: true }),\n current: source.current,\n }\n}\n","/**\n * Surface-scoped profile overlay — the seam letting any product page (a\n * sequence editor, a brief composer, a dataset view) add MCP servers, a prompt\n * addendum, and permission tightening to the workspace agent profile for turns\n * initiated FROM that surface, without the chat orchestrator knowing any\n * surface's specifics. The orchestrator resolves `(kind, ctx)` through a\n * registry the REQUEST HANDLER constructs per request (construction is a Map\n * build — cheap) and merges the result into the base profile it was about to\n * send to the sandbox. Per-request construction is the trust mechanism, not an\n * optimization target: each `build()` closes over server-trusted request state\n * (env bindings, secrets, the AUTHENTICATED user/workspace), which on Workers\n * exists only per request — a startup-built registry would force identity\n * through the untrusted client `ctx`.\n *\n * SECURITY INVARIANT: the surface `kind` and the ids inside `ctx` arrive on\n * the client request and are pure ROUTING data — never trusted content, never\n * identity. Identity comes from the closure (see above). The registered\n * `build()` runs server-side only: it validates the routing ids against the\n * product's access control, then mints its own URLs from server configuration\n * (`buildHttpMcpServer` in ../tools). A client can therefore never inject an\n * arbitrary MCP url, header, or credential into the agent profile: the\n * overlay's `mcp` values are typed as {@link SurfaceMcpServer} (= the\n * server-built `AppToolMcpServer` entry shape), and only build() constructs\n * them.\n *\n * The credential itself never appears in the overlay. Since the tagged-config\n * contract (`agent-interface` 0.38.0) the `Authorization` header is a\n * `secret-ref` naming a box-environment variable, which the sandbox resolves\n * privately; `build()` supplies that key NAME from server configuration and the\n * product writes the value through `SandboxRuntimeConfig.env` at creation or\n * refreshes it through `SandboxRuntimeConfig.runtimeEnv` before retained-box\n * bootstrap. The value remains workspace-scoped because every member and turn\n * shares the box; runtime renewal does not create a per-user secret channel.\n */\n\nimport type { AppToolMcpServer } from '../tools/mcp'\n\n/** Sandbox permission posture values, ranked deny > ask > allow for merging. */\nexport type SurfacePermissionValue = 'allow' | 'ask' | 'deny'\n\n/** The only MCP entry shape an overlay may carry: the server-built bridge\n * entry from ../tools/mcp (transport, url, headers, and capability token all\n * assembled server-side). The alias exists so overlay authors reach for the\n * builders in ../tools rather than hand-rolling `{ url: ctx.url }` shapes\n * that would let request data become a dialable endpoint. */\nexport type SurfaceMcpServer = AppToolMcpServer\n\n/** What one surface contributes to the agent profile for a single turn. */\nexport interface SurfaceOverlay {\n /** MCP servers to mount for this turn, keyed by tool-routing name. Names\n * must not collide with the base profile's — see {@link mergeSurfaceOverlay}. */\n mcp?: Record<string, SurfaceMcpServer>\n /** Appended to the base system-prompt addendum with a blank-line separator. */\n promptAddendum?: string\n /** Per-key posture the surface wants for its turns. Merging is monotone\n * fail-closed: the stricter of base/overlay wins, so a surface can tighten\n * the workspace posture but never relax it. */\n permissions?: Record<string, SurfacePermissionValue>\n}\n\n/**\n * One registered surface kind. `TCtx` is the shape build() expects — a CLAIM\n * about the client payload, not a guarantee: the registry hands build() the\n * request's `ctx` unvalidated, so build() must treat every field as an\n * untrusted id (resolve it through access control that throws on a bad or\n * foreign id) before minting anything from it.\n */\nexport interface SurfaceKindDefinition<TCtx> {\n kind: string\n build: (ctx: TCtx) => SurfaceOverlay | Promise<SurfaceOverlay>\n}\n\n/** The variance-erased form a registry accepts (`build` is contravariant in\n * `TCtx`, so every concrete definition is assignable to this). */\nexport type AnySurfaceKind = SurfaceKindDefinition<never>\n\n/**\n * Declare one surface kind. The `kind` string is the client-visible routing\n * key (e.g. `'sequences'`); `build` is the server-side factory that turns a\n * validated ctx into the overlay for one turn.\n */\nexport function defineSurfaceKind<TCtx>(opts: {\n kind: string\n build: (ctx: TCtx) => SurfaceOverlay | Promise<SurfaceOverlay>\n}): SurfaceKindDefinition<TCtx> {\n if (typeof opts.kind !== 'string' || opts.kind.length === 0 || /\\s/.test(opts.kind)) {\n throw new Error(`surface kind must be a non-empty string without whitespace (got ${JSON.stringify(opts.kind)})`)\n }\n if (typeof opts.build !== 'function') {\n throw new Error(`surface kind '${opts.kind}' requires a build function`)\n }\n return { kind: opts.kind, build: opts.build }\n}\n\n/** Resolve and build the overlay for a given surface kind within a turn context */\nexport interface SurfaceRegistry {\n /** Build the overlay for one turn. Throws on an unknown kind — an unknown\n * surface is a routing bug (client and server registries drifted), and\n * silently returning an empty overlay would strip the surface's tools from\n * the turn with no signal anywhere. Build errors propagate unwrapped. */\n resolve(kind: string, ctx: unknown): Promise<SurfaceOverlay>\n}\n\n/**\n * Assemble the product's surface registry from its registered kinds. Duplicate\n * kinds throw at construction: two builders behind one routing key would make\n * the mounted toolset depend on registration order.\n */\nexport function createSurfaceRegistry(kinds: readonly AnySurfaceKind[]): SurfaceRegistry {\n const byKind = new Map<string, AnySurfaceKind>()\n for (const definition of kinds) {\n if (byKind.has(definition.kind)) {\n throw new Error(`duplicate surface kind '${definition.kind}' — each kind must be registered exactly once`)\n }\n byKind.set(definition.kind, definition)\n }\n\n return {\n async resolve(kind, ctx) {\n const definition = byKind.get(kind)\n if (!definition) {\n const known = [...byKind.keys()].join(', ') || '(none)'\n throw new Error(\n `unknown surface kind '${kind}' — registered kinds: ${known}. ` +\n 'An unknown surface is a routing bug: register the kind via defineSurfaceKind before clients can reference it.',\n )\n }\n // The trust boundary where static ctx typing ends: the request payload is\n // handed to build() as-is, and build() validates it (see SurfaceKindDefinition).\n const overlay = await definition.build(ctx as never)\n assertSurfaceOverlay(overlay, `surface kind '${kind}'`)\n return overlay\n },\n }\n}\n\n/** Base-profile slice the merge reads/writes. Real callers pass their full\n * profile object; every field outside this slice passes through untouched. */\nexport interface SurfaceMergeBase {\n mcp?: Record<string, unknown>\n systemPromptAddendum?: string\n permissions?: Record<string, SurfacePermissionValue>\n}\n\nconst PERMISSION_SEVERITY: Record<SurfacePermissionValue, number> = { allow: 0, ask: 1, deny: 2 }\n\n/**\n * Merge one surface overlay into a base profile, returning a new object\n * (the base is never mutated; untouched nested records are shared by\n * reference).\n *\n * - `mcp`: overlay servers are added under their own names. A name already\n * present on the base THROWS — a collision is two servers claiming one\n * routing name, and renaming either silently would corrupt tool routing for\n * whichever caller expected the original binding.\n * - `systemPromptAddendum`: the overlay's `promptAddendum` appends after a\n * blank-line separator (no separator when the base has no addendum).\n * - `permissions`: per key the STRICTER value wins (deny > ask > allow). A\n * surface can tighten the base posture for its turns; a base 'deny' survives\n * any overlay.\n */\nexport function mergeSurfaceOverlay<TBase extends SurfaceMergeBase>(\n base: TBase,\n overlay: SurfaceOverlay,\n): TBase & SurfaceMergeBase {\n assertSurfaceOverlay(overlay, 'surface overlay')\n const merged: SurfaceMergeBase = { ...base }\n\n if (overlay.mcp && Object.keys(overlay.mcp).length > 0) {\n const baseMcp = base.mcp ?? {}\n const collisions = Object.keys(overlay.mcp).filter((name) => name in baseMcp)\n if (collisions.length > 0) {\n throw new Error(\n `surface overlay MCP name collision: ${collisions.map((n) => `'${n}'`).join(', ')} already exist on the base profile. ` +\n 'Two servers cannot claim one name — give the surface server a distinct name.',\n )\n }\n merged.mcp = { ...baseMcp, ...overlay.mcp }\n }\n\n if (overlay.promptAddendum !== undefined) {\n merged.systemPromptAddendum = base.systemPromptAddendum\n ? `${base.systemPromptAddendum}\\n\\n${overlay.promptAddendum}`\n : overlay.promptAddendum\n }\n\n if (overlay.permissions && Object.keys(overlay.permissions).length > 0) {\n const permissions: Record<string, SurfacePermissionValue> = { ...(base.permissions ?? {}) }\n for (const [key, value] of Object.entries(overlay.permissions)) {\n const existing = permissions[key]\n permissions[key] =\n existing === undefined || PERMISSION_SEVERITY[value] > PERMISSION_SEVERITY[existing] ? value : existing\n }\n merged.permissions = permissions\n }\n\n // merged began as a shallow copy of base; only the three slice fields were\n // replaced, so the intersection type is the true shape.\n return merged as TBase & SurfaceMergeBase\n}\n\n/** Reject overlays a build() (or hand-rolled caller) malformed, with the exact\n * field named: a relative MCP url, a blank addendum, or an off-vocabulary\n * permission would otherwise surface only as an opaque sandbox failure. */\nfunction assertSurfaceOverlay(overlay: SurfaceOverlay, label: string): void {\n if (overlay.promptAddendum !== undefined) {\n if (typeof overlay.promptAddendum !== 'string' || overlay.promptAddendum.trim().length === 0) {\n throw new Error(`${label}: promptAddendum must be a non-blank string when provided`)\n }\n }\n if (overlay.mcp !== undefined) {\n for (const [name, server] of Object.entries(overlay.mcp)) {\n if (name.trim().length === 0) throw new Error(`${label}: MCP server names must be non-empty`)\n if (server.transport !== 'http') {\n throw new Error(`${label}: MCP server '${name}' must use transport 'http' (got ${JSON.stringify((server as { transport?: unknown }).transport)})`)\n }\n let parsed: URL\n try {\n parsed = new URL(server.url)\n } catch {\n throw new Error(`${label}: MCP server '${name}' url must be an absolute URL (got ${JSON.stringify(server.url)})`)\n }\n if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n throw new Error(`${label}: MCP server '${name}' url must be http(s) (got ${JSON.stringify(server.url)})`)\n }\n }\n }\n if (overlay.permissions !== undefined) {\n for (const [key, value] of Object.entries(overlay.permissions)) {\n if (!(value in PERMISSION_SEVERITY)) {\n throw new Error(`${label}: permission '${key}' must be 'allow' | 'ask' | 'deny' (got ${JSON.stringify(value)})`)\n }\n }\n }\n}\n"],"mappings":"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","names":[]}