@athenaintel/react 0.57.2 → 0.60.0

package/dist/tools/auto-open-tools.cjs

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const assetPanelStore = require("../assets/asset-panel-store.cjs");
 const assetUtils = require("./asset-utils.cjs");
+const toolNames = require("../agent-runtime/src/tool-names.cjs");
+const ptcSubcalls = require("../agent-runtime/src/ptc-subcalls.cjs");
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const normalizeResult = (result) => {
   if (!result) return null;
@@ -38,86 +40,157 @@ const pickNumber = (...candidates) => {
   }
   return void 0;
 };
-const autoOpen = (assetId, options = {}) => {
+const AUTO_OPEN_SPECS = {
+  // Top-level asset creators
+  create_new_document: { type: "document", kind: "created" },
+  create_document_from_markdown: { type: "document", kind: "created" },
+  create_new_sheet: { type: "spreadsheet", kind: "created" },
+  create_powerpoint_deck: { type: "presentation", kind: "created" },
+  create_presentation_pptx_studio: { type: "presentation", kind: "created" },
+  create_new_notebook: { type: "notebook", kind: "created" },
+  // Open / read existing assets
+  open_asset_in_workspace: { type: "unknown", kind: "shown", from: "args" },
+  // Code execution that lands on a deck/slide
+  execute_presentation_code: { type: "presentation", kind: "touched" },
+  // Media capture: a screenshot or clip of a video, a new asset
+  capture_moment: { type: "unknown", kind: "created" },
+  // Studio PTC sub-calls (nested SDK commands): as nested tool calls where a runtime nests them, else
+  // read off the script's call once it answers (`studioCreations`).
+  CreateWorkbook: { type: "spreadsheet", kind: "created" },
+  AddSheet: { type: "spreadsheet", kind: "touched" },
+  OpenWorkbook: { type: "spreadsheet", kind: "touched" },
+  CreatePresentation: { type: "presentation", kind: "created" },
+  OpenPresentation: { type: "presentation", kind: "touched", preserveExistingSlide: true },
+  AddSlide: { type: "presentation", kind: "touched" },
+  CreateDocument: { type: "document", kind: "created" },
+  CreateParagraph: { type: "document", kind: "touched" },
+  OpenDocument: { type: "document", kind: "touched" }
+};
+const isAutoOpenTool = (tool) => Object.hasOwn(AUTO_OPEN_SPECS, tool);
+const answerOpensNothing = ({
+  isError,
+  data
+}) => isError === true || (data == null ? void 0 : data.status) === "error" || (data == null ? void 0 : data.followModeOff) === true;
+function openAutomatically({
+  assetId,
+  tool,
+  spec,
+  slideNumber
+}) {
   const store = assetPanelStore.useAssetPanelStore.getState();
-  if (!store.markAutoOpened(assetId)) return;
+  if (!store.markAutoOpened(assetId, spec.kind)) return;
   const existing = store.tabs.find((tab) => tab.id === assetId);
-  const keepCurrentSlide = options.preserveExistingSlide && existing;
+  const keepCurrentSlide = spec.preserveExistingSlide && existing;
   store.openAsset(assetId, {
-    type: options.type ?? "unknown",
-    // A host's own opener tells an open nobody clicked from one the person asked for.
+    type: spec.type,
+    // A host's own opener tells an open nobody clicked from one the person asked for, and what
+    // the tool did with the asset.
     origin: "auto",
-    ...keepCurrentSlide || options.slideNumber === void 0 ? {} : { slideNumber: options.slideNumber }
+    autoOpen: { tool, kind: spec.kind },
+    ...keepCurrentSlide || slideNumber === void 0 ? {} : { slideNumber }
   });
-};
-const openOnResult = (type, extra) => ({
-  streamCall: async (reader) => {
-    const { result } = await reader.response.get();
-    const data = normalizeResult(result);
-    const assetId = pickAssetId(
-      data == null ? void 0 : data.asset_id,
-      data == null ? void 0 : data.assetId,
-      data == null ? void 0 : data.id
-    );
-    if (!assetId) return;
-    let slideNumber;
-    if ((extra == null ? void 0 : extra.slideNumberFrom) !== "args") {
-      slideNumber = pickNumber(
-        data == null ? void 0 : data.slide_number,
-        data == null ? void 0 : data.slideNumber,
-        data == null ? void 0 : data.targetSlideNumber,
-        data == null ? void 0 : data.target_slide_number
-      );
+}
+function studioCreations({
+  artifact
+}) {
+  return ptcSubcalls.ptcSubcallsFromArtifact(artifact).flatMap((call) => {
+    if (call.status !== "completed" || !isAutoOpenTool(call.name)) return [];
+    if (AUTO_OPEN_SPECS[call.name].kind !== "created") return [];
+    const data = normalizeResult(call.result);
+    const assetId = pickAssetId(data == null ? void 0 : data.assetId, data == null ? void 0 : data.asset_id, data == null ? void 0 : data.id);
+    return assetId ? [{ tool: call.name, assetId, subcallId: call.id }] : [];
+  });
+}
+function creationsOfCall({
+  toolCallId,
+  tool,
+  result,
+  isError,
+  artifact,
+  args
+}) {
+  const made = [];
+  if (toolNames.PTC_PARENT_TOOL_NAMES.has(tool)) {
+    for (const creation of studioCreations({ artifact })) {
+      made.push({
+        key: `${toolCallId}:${creation.subcallId}`,
+        assetId: creation.assetId,
+        type: AUTO_OPEN_SPECS[creation.tool].type,
+        autoOpen: { tool: creation.tool, kind: "created" }
+      });
     }
-    if (slideNumber === void 0 && (extra == null ? void 0 : extra.slideNumberFrom) !== "result") {
-      const args = await reader.args.get().catch(() => null);
-      slideNumber = pickNumber(
-        args == null ? void 0 : args.slide_number,
-        args == null ? void 0 : args.slideNumber,
-        args == null ? void 0 : args.targetSlideNumber,
-        args == null ? void 0 : args.target_slide_number
-      );
+  }
+  if (!isAutoOpenTool(tool)) return made;
+  const spec = AUTO_OPEN_SPECS[tool];
+  if (spec.kind === "touched") return made;
+  const data = normalizeResult(result);
+  if (answerOpensNothing({ isError, data })) return made;
+  const callArgs = isRecord(args) ? args : null;
+  const assetId = spec.from === "args" ? pickAssetId(data == null ? void 0 : data.assetId, data == null ? void 0 : data.asset_id, callArgs == null ? void 0 : callArgs.asset_id, callArgs == null ? void 0 : callArgs.assetId) : pickAssetId(data == null ? void 0 : data.asset_id, data == null ? void 0 : data.assetId, data == null ? void 0 : data.id);
+  if (assetId) made.push({ key: toolCallId, assetId, type: spec.type, autoOpen: { tool, kind: spec.kind } });
+  return made;
+}
+async function autoOpenOnAnswer({
+  tool,
+  answer,
+  args
+}) {
+  const script = toolNames.PTC_PARENT_TOOL_NAMES.has(tool);
+  if (!script && !isAutoOpenTool(tool)) return;
+  const { result, isError, artifact } = await answer();
+  if (script) {
+    for (const made of studioCreations({ artifact })) {
+      openAutomatically({ assetId: made.assetId, tool: made.tool, spec: AUTO_OPEN_SPECS[made.tool] });
     }
-    autoOpen(assetId, {
-      type,
-      slideNumber,
-      preserveExistingSlide: extra == null ? void 0 : extra.preserveExistingSlide
-    });
   }
-});
-const openFromArgs = (type) => ({
-  streamCall: async (reader) => {
-    await reader.response.get();
-    const args = await reader.args.get().catch(() => null);
-    const assetId = pickAssetId(args == null ? void 0 : args.asset_id, args == null ? void 0 : args.assetId);
+  if (!isAutoOpenTool(tool)) return;
+  const spec = AUTO_OPEN_SPECS[tool];
+  const data = normalizeResult(result);
+  if (answerOpensNothing({ isError, data })) return;
+  let assetId;
+  let slideNumber;
+  if (spec.from === "args") {
+    const read = await args().catch(() => null);
+    const callArgs = isRecord(read) ? read : null;
+    assetId = pickAssetId(callArgs == null ? void 0 : callArgs.asset_id, callArgs == null ? void 0 : callArgs.assetId);
+  } else {
+    assetId = pickAssetId(data == null ? void 0 : data.asset_id, data == null ? void 0 : data.assetId, data == null ? void 0 : data.id);
     if (!assetId) return;
-    autoOpen(assetId, { type });
+    slideNumber = pickNumber(
+      data == null ? void 0 : data.slide_number,
+      data == null ? void 0 : data.slideNumber,
+      data == null ? void 0 : data.targetSlideNumber,
+      data == null ? void 0 : data.target_slide_number
+    );
+    if (slideNumber === void 0) {
+      const read = await args().catch(() => null);
+      const callArgs = isRecord(read) ? read : null;
+      slideNumber = pickNumber(
+        callArgs == null ? void 0 : callArgs.slide_number,
+        callArgs == null ? void 0 : callArgs.slideNumber,
+        callArgs == null ? void 0 : callArgs.targetSlideNumber,
+        callArgs == null ? void 0 : callArgs.target_slide_number
+      );
+    }
   }
-});
-const DEFAULT_AUTO_OPEN_TOOLS = {
-  // Top-level asset creators
-  create_new_document: openOnResult("document"),
-  create_document_from_markdown: openOnResult("document"),
-  create_new_sheet: openOnResult("spreadsheet"),
-  create_powerpoint_deck: openOnResult("presentation"),
-  create_presentation_pptx_studio: openOnResult("presentation"),
-  create_new_notebook: openOnResult("notebook"),
-  // Open / read existing assets
-  open_asset_in_workspace: openFromArgs("unknown"),
-  // Code execution that lands on a deck/slide
-  execute_presentation_code: openOnResult("presentation"),
-  // Media capture
-  capture_moment: openOnResult("unknown"),
-  // Studio PTC sub-calls (nested SDK commands)
-  CreateWorkbook: openOnResult("spreadsheet"),
-  AddSheet: openOnResult("spreadsheet"),
-  OpenWorkbook: openOnResult("spreadsheet"),
-  CreatePresentation: openOnResult("presentation"),
-  OpenPresentation: openOnResult("presentation", { preserveExistingSlide: true }),
-  AddSlide: openOnResult("presentation"),
-  CreateDocument: openOnResult("document"),
-  CreateParagraph: openOnResult("document"),
-  OpenDocument: openOnResult("document")
-};
+  if (!assetId) return;
+  openAutomatically({ assetId, tool, spec, slideNumber });
+}
+const DEFAULT_AUTO_OPEN_TOOLS = Object.fromEntries(
+  [.../* @__PURE__ */ new Set([...Object.keys(AUTO_OPEN_SPECS), ...toolNames.PTC_PARENT_TOOL_NAMES])].map((tool) => [
+    tool,
+    {
+      streamCall: async (reader) => {
+        await autoOpenOnAnswer({
+          tool,
+          answer: () => reader.response.get(),
+          args: () => reader.args.get()
+        });
+      }
+    }
+  ])
+);
 exports.DEFAULT_AUTO_OPEN_TOOLS = DEFAULT_AUTO_OPEN_TOOLS;
+exports.autoOpenOnAnswer = autoOpenOnAnswer;
+exports.creationsOfCall = creationsOfCall;
 //# sourceMappingURL=auto-open-tools.cjs.map

package/dist/tools/auto-open-tools.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"auto-open-tools.cjs","sources":["../../src/tools/auto-open-tools.ts"],"sourcesContent":["import type { Toolkit } from '@assistant-ui/react';\nimport { useAssetPanelStore, type AssetType } from '../assets/asset-panel-store';\nimport { tryParseJson } from './asset-utils';\n\ntype AnyRecord = Record<string, unknown>;\n\nconst isRecord = (value: unknown): value is AnyRecord =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst normalizeResult = (result: unknown): AnyRecord | null => {\n  if (!result) return null;\n  if (typeof result === 'string') {\n    const parsed = tryParseJson(result);\n    if (isRecord(parsed)) return parsed;\n    return null;\n  }\n  if (isRecord(result)) {\n    const inner = (result as AnyRecord).result;\n    if (typeof inner === 'string') {\n      const parsed = tryParseJson(inner);\n      if (isRecord(parsed)) return parsed;\n    } else if (isRecord(inner)) {\n      return inner;\n    }\n    return result;\n  }\n  return null;\n};\n\nconst pickAssetId = (...candidates: unknown[]): string | null => {\n  for (const candidate of candidates) {\n    if (typeof candidate === 'string' && candidate.startsWith('asset_')) {\n      return candidate;\n    }\n  }\n  return null;\n};\n\nconst pickNumber = (...candidates: unknown[]): number | undefined => {\n  for (const candidate of candidates) {\n    if (typeof candidate === 'number' && Number.isFinite(candidate)) {\n      return candidate;\n    }\n  }\n  return undefined;\n};\n\nconst autoOpen = (\n  assetId: string,\n  options: { type?: AssetType; slideNumber?: number; preserveExistingSlide?: boolean } = {},\n) => {\n  const store = useAssetPanelStore.getState();\n  if (!store.markAutoOpened(assetId)) return;\n  const existing = store.tabs.find((tab) => tab.id === assetId);\n  const keepCurrentSlide = options.preserveExistingSlide && existing;\n  store.openAsset(assetId, {\n    type: options.type ?? 'unknown',\n    // A host's own opener tells an open nobody clicked from one the person asked for.\n    origin: 'auto',\n    ...(keepCurrentSlide || options.slideNumber === undefined\n      ? {}\n      : { slideNumber: options.slideNumber }),\n  });\n};\n\nconst openOnResult = (\n  type: AssetType,\n  extra?: {\n    slideNumberFrom?: 'args' | 'result' | 'both';\n    preserveExistingSlide?: boolean;\n  },\n): Toolkit[string] => ({\n  streamCall: async (reader) => {\n    const { result } = await reader.response.get();\n    const data = normalizeResult(result);\n    const assetId = pickAssetId(\n      data?.asset_id,\n      data?.assetId,\n      (data as { id?: unknown })?.id,\n    );\n    if (!assetId) return;\n\n    let slideNumber: number | undefined;\n    if (extra?.slideNumberFrom !== 'args') {\n      slideNumber = pickNumber(\n        data?.slide_number,\n        data?.slideNumber,\n        data?.targetSlideNumber,\n        data?.target_slide_number,\n      );\n    }\n    if (slideNumber === undefined && extra?.slideNumberFrom !== 'result') {\n      const args = (await reader.args.get().catch(() => null)) as AnyRecord | null;\n      slideNumber = pickNumber(\n        args?.slide_number,\n        args?.slideNumber,\n        args?.targetSlideNumber,\n        args?.target_slide_number,\n      );\n    }\n\n    autoOpen(assetId, {\n      type,\n      slideNumber,\n      preserveExistingSlide: extra?.preserveExistingSlide,\n    });\n  },\n});\n\nconst openFromArgs = (type: AssetType): Toolkit[string] => ({\n  streamCall: async (reader) => {\n    await reader.response.get();\n    const args = (await reader.args.get().catch(() => null)) as AnyRecord | null;\n    const assetId = pickAssetId(args?.asset_id, args?.assetId);\n    if (!assetId) return;\n    autoOpen(assetId, { type });\n  },\n});\n\n/**\n * Default frontend tools that auto-open the asset a tool just created or\n * touched. Registered automatically by `AthenaProvider` / `AthenaChat`; pass\n * `disableAutoOpen` to turn off, or override individual entries via\n * `frontendTools`.\n */\nexport const DEFAULT_AUTO_OPEN_TOOLS: Toolkit = {\n  // Top-level asset creators\n  create_new_document: openOnResult('document'),\n  create_document_from_markdown: openOnResult('document'),\n  create_new_sheet: openOnResult('spreadsheet'),\n  create_powerpoint_deck: openOnResult('presentation'),\n  create_presentation_pptx_studio: openOnResult('presentation'),\n  create_new_notebook: openOnResult('notebook'),\n\n  // Open / read existing assets\n  open_asset_in_workspace: openFromArgs('unknown'),\n\n  // Code execution that lands on a deck/slide\n  execute_presentation_code: openOnResult('presentation'),\n\n  // Media capture\n  capture_moment: openOnResult('unknown'),\n\n  // Studio PTC sub-calls (nested SDK commands)\n  CreateWorkbook: openOnResult('spreadsheet'),\n  AddSheet: openOnResult('spreadsheet'),\n  OpenWorkbook: openOnResult('spreadsheet'),\n  CreatePresentation: openOnResult('presentation'),\n  OpenPresentation: openOnResult('presentation', { preserveExistingSlide: true }),\n  AddSlide: openOnResult('presentation'),\n  CreateDocument: openOnResult('document'),\n  CreateParagraph: openOnResult('document'),\n  OpenDocument: openOnResult('document'),\n};\n"],"names":["tryParseJson","useAssetPanelStore"],"mappings":"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"}
+{"version":3,"file":"auto-open-tools.cjs","sources":["../../src/tools/auto-open-tools.ts"],"sourcesContent":["import type { Toolkit } from '@assistant-ui/react';\nimport { PTC_PARENT_TOOL_NAMES, ptcSubcallsFromArtifact } from '@athenaintel/agent-runtime';\nimport {\n  type AssetAutoOpen,\n  type AssetAutoOpenKind,\n  type AssetType,\n  useAssetPanelStore,\n} from '../assets/asset-panel-store';\nimport { tryParseJson } from './asset-utils';\n\ntype AnyRecord = Record<string, unknown>;\n\nconst isRecord = (value: unknown): value is AnyRecord =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst normalizeResult = (result: unknown): AnyRecord | null => {\n  if (!result) return null;\n  if (typeof result === 'string') {\n    const parsed = tryParseJson(result);\n    if (isRecord(parsed)) return parsed;\n    return null;\n  }\n  if (isRecord(result)) {\n    const inner = (result as AnyRecord).result;\n    if (typeof inner === 'string') {\n      const parsed = tryParseJson(inner);\n      if (isRecord(parsed)) return parsed;\n    } else if (isRecord(inner)) {\n      return inner;\n    }\n    return result;\n  }\n  return null;\n};\n\nconst pickAssetId = (...candidates: unknown[]): string | null => {\n  for (const candidate of candidates) {\n    if (typeof candidate === 'string' && candidate.startsWith('asset_')) {\n      return candidate;\n    }\n  }\n  return null;\n};\n\nconst pickNumber = (...candidates: unknown[]): number | undefined => {\n  for (const candidate of candidates) {\n    if (typeof candidate === 'number' && Number.isFinite(candidate)) {\n      return candidate;\n    }\n  }\n  return undefined;\n};\n\n/** How a default tool auto-opens the asset its call names. */\ninterface AutoOpenSpec {\n  type: AssetType;\n  /** What the tool did with the asset (`AssetAutoOpenKind`), told to a host's opener. */\n  kind: AssetAutoOpenKind;\n  /** Where the asset id is: the call's result (default), or its arguments once it answered. */\n  from?: 'result' | 'args';\n  /** Keep the slide an open deck shows instead of moving to the one the call names. */\n  preserveExistingSlide?: boolean;\n}\n\n/**\n * The tools whose call opens the asset it names, and what each did with it: made it, opened it for\n * the person to see, or read or changed one that was there.\n */\nconst AUTO_OPEN_SPECS = {\n  // Top-level asset creators\n  create_new_document: { type: 'document', kind: 'created' },\n  create_document_from_markdown: { type: 'document', kind: 'created' },\n  create_new_sheet: { type: 'spreadsheet', kind: 'created' },\n  create_powerpoint_deck: { type: 'presentation', kind: 'created' },\n  create_presentation_pptx_studio: { type: 'presentation', kind: 'created' },\n  create_new_notebook: { type: 'notebook', kind: 'created' },\n\n  // Open / read existing assets\n  open_asset_in_workspace: { type: 'unknown', kind: 'shown', from: 'args' },\n\n  // Code execution that lands on a deck/slide\n  execute_presentation_code: { type: 'presentation', kind: 'touched' },\n\n  // Media capture: a screenshot or clip of a video, a new asset\n  capture_moment: { type: 'unknown', kind: 'created' },\n\n  // Studio PTC sub-calls (nested SDK commands): as nested tool calls where a runtime nests them, else\n  // read off the script's call once it answers (`studioCreations`).\n  CreateWorkbook: { type: 'spreadsheet', kind: 'created' },\n  AddSheet: { type: 'spreadsheet', kind: 'touched' },\n  OpenWorkbook: { type: 'spreadsheet', kind: 'touched' },\n  CreatePresentation: { type: 'presentation', kind: 'created' },\n  OpenPresentation: { type: 'presentation', kind: 'touched', preserveExistingSlide: true },\n  AddSlide: { type: 'presentation', kind: 'touched' },\n  CreateDocument: { type: 'document', kind: 'created' },\n  CreateParagraph: { type: 'document', kind: 'touched' },\n  OpenDocument: { type: 'document', kind: 'touched' },\n} satisfies Record<string, AutoOpenSpec>;\n\n/** The tools the SDK auto-opens after, by name. */\nexport type AutoOpenTool = keyof typeof AUTO_OPEN_SPECS;\n\nconst isAutoOpenTool = (tool: string): tool is AutoOpenTool =>\n  Object.hasOwn(AUTO_OPEN_SPECS, tool);\n\n/**\n * Whether a call's answer says the open it would show did not happen: the call failed, agora\n * refused it (`status: 'error'`: `open_asset_in_workspace` for an asset the person may not see, or\n * outside the session's workspace, answers with no asset), or agora left the person's view alone and\n * told the agent so (`followModeOff`, the web app with follow mode off). An open the agent was told\n * did not happen never happens.\n */\nconst answerOpensNothing = ({\n  isError,\n  data,\n}: {\n  isError: boolean | undefined;\n  data: AnyRecord | null;\n}): boolean => isError === true || data?.status === 'error' || data?.followModeOff === true;\n\n/** Opens `assetId` as the tool behind `spec` opens it, once per generation (`markAutoOpened`). */\nfunction openAutomatically({\n  assetId,\n  tool,\n  spec,\n  slideNumber,\n}: {\n  assetId: string;\n  tool: string;\n  spec: AutoOpenSpec;\n  slideNumber?: number;\n}): void {\n  const store = useAssetPanelStore.getState();\n  if (!store.markAutoOpened(assetId, spec.kind)) return;\n  const existing = store.tabs.find((tab) => tab.id === assetId);\n  const keepCurrentSlide = spec.preserveExistingSlide && existing;\n  store.openAsset(assetId, {\n    type: spec.type,\n    // A host's own opener tells an open nobody clicked from one the person asked for, and what\n    // the tool did with the asset.\n    origin: 'auto',\n    autoOpen: { tool, kind: spec.kind },\n    ...(keepCurrentSlide || slideNumber === undefined ? {} : { slideNumber }),\n  });\n}\n\n/**\n * What a studio script made (a sandbox `execute` / `eval` or a studio executor, `PTC_PARENT_TOOL_NAMES`):\n * each `Create*` sub-call the backend promoted onto the call's artifact (`ptcSubcallsFromArtifact`)\n * that answered with its asset, by the sub-call's own answer. The deep agent's runtime keeps a\n * script's sub-calls on that artifact rather than as nested tool calls, so they never reach a tool's\n * own `streamCall`: the script's call opens what they made once it answers, as Athena on the web's\n * studio follow reads them (`extractCompletedPtcParents`).\n */\nfunction studioCreations({\n  artifact,\n}: {\n  artifact: unknown;\n}): Array<{ tool: AutoOpenTool; assetId: string; subcallId: string }> {\n  return ptcSubcallsFromArtifact(artifact).flatMap((call) => {\n    if (call.status !== 'completed' || !isAutoOpenTool(call.name)) return [];\n    if (AUTO_OPEN_SPECS[call.name].kind !== 'created') return [];\n    const data = normalizeResult(call.result);\n    const assetId = pickAssetId(data?.assetId, data?.asset_id, data?.id);\n    return assetId ? [{ tool: call.name, assetId, subcallId: call.id }] : [];\n  });\n}\n\n/** An asset an agent's finished tool call made, or opened for the person to see. */\nexport interface AgentCreation {\n  /** The call's own id, and a script's sub-call's after it: one creation, one key. */\n  key: string;\n  assetId: string;\n  type: AssetType;\n  /** The tool that made or showed it, and which (`created` or `shown`). */\n  autoOpen: AssetAutoOpen;\n}\n\n/**\n * What one finished tool call made or showed the person, by the auto-open rules above: each asset a\n * studio script's `Create*` sub-calls made (`studioCreations`), and the asset a create tool made or\n * `open_asset_in_workspace` showed, unless the call's answer says it did not happen\n * (`answerOpensNothing`). Never what a call only read or changed (`touched`).\n */\nexport function creationsOfCall({\n  toolCallId,\n  tool,\n  result,\n  isError,\n  artifact,\n  args,\n}: {\n  toolCallId: string;\n  tool: string;\n  result: unknown;\n  isError?: boolean;\n  artifact?: unknown;\n  /** The call's arguments, as its AI message asked for it. */\n  args?: unknown;\n}): AgentCreation[] {\n  const made: AgentCreation[] = [];\n  if (PTC_PARENT_TOOL_NAMES.has(tool)) {\n    for (const creation of studioCreations({ artifact })) {\n      made.push({\n        key: `${toolCallId}:${creation.subcallId}`,\n        assetId: creation.assetId,\n        type: AUTO_OPEN_SPECS[creation.tool].type,\n        autoOpen: { tool: creation.tool, kind: 'created' },\n      });\n    }\n  }\n  if (!isAutoOpenTool(tool)) return made;\n  const spec: AutoOpenSpec = AUTO_OPEN_SPECS[tool];\n  if (spec.kind === 'touched') return made;\n  const data = normalizeResult(result);\n  if (answerOpensNothing({ isError, data })) return made;\n  const callArgs = isRecord(args) ? args : null;\n  const assetId =\n    spec.from === 'args'\n      ? pickAssetId(data?.assetId, data?.asset_id, callArgs?.asset_id, callArgs?.assetId)\n      : pickAssetId(data?.asset_id, data?.assetId, data?.id);\n  if (assetId) made.push({ key: toolCallId, assetId, type: spec.type, autoOpen: { tool, kind: spec.kind } });\n  return made;\n}\n\n/**\n * Opens what a default auto-open tool's call names (`DEFAULT_AUTO_OPEN_TOOLS`), once that call\n * answered: for a studio script, each asset its `Create*` sub-calls made (`studioCreations`); then,\n * for a tool with a spec, the id in its result (or, for `open_asset_in_workspace`, its arguments),\n * at the slide either names. Each with what the tool did with it (`autoOpen`) for a host's opener.\n * Nothing for a call that names no asset, one whose answer says it did not happen\n * (`answerOpensNothing`), or an asset already auto-opened (`markAutoOpened`).\n */\nexport async function autoOpenOnAnswer({\n  tool,\n  answer,\n  args,\n}: {\n  tool: string;\n  /** The call's answer, once it came: its result, whether the call failed, and its artifact. */\n  answer: () => Promise<{ result: unknown; isError?: boolean; artifact?: unknown }>;\n  /** The call's arguments (null when they could not be read). */\n  args: () => Promise<unknown>;\n}): Promise<void> {\n  const script = PTC_PARENT_TOOL_NAMES.has(tool);\n  if (!script && !isAutoOpenTool(tool)) return;\n  const { result, isError, artifact } = await answer();\n  // What the script made opens whatever became of the script after: it is there either way.\n  if (script) {\n    for (const made of studioCreations({ artifact })) {\n      openAutomatically({ assetId: made.assetId, tool: made.tool, spec: AUTO_OPEN_SPECS[made.tool] });\n    }\n  }\n  if (!isAutoOpenTool(tool)) return;\n  const spec: AutoOpenSpec = AUTO_OPEN_SPECS[tool];\n  const data = normalizeResult(result);\n  if (answerOpensNothing({ isError, data })) return;\n  let assetId: string | null;\n  let slideNumber: number | undefined;\n  if (spec.from === 'args') {\n    const read = await args().catch(() => null);\n    const callArgs = isRecord(read) ? read : null;\n    assetId = pickAssetId(callArgs?.asset_id, callArgs?.assetId);\n  } else {\n    assetId = pickAssetId(data?.asset_id, data?.assetId, data?.id);\n    if (!assetId) return;\n    slideNumber = pickNumber(\n      data?.slide_number,\n      data?.slideNumber,\n      data?.targetSlideNumber,\n      data?.target_slide_number,\n    );\n    if (slideNumber === undefined) {\n      const read = await args().catch(() => null);\n      const callArgs = isRecord(read) ? read : null;\n      slideNumber = pickNumber(\n        callArgs?.slide_number,\n        callArgs?.slideNumber,\n        callArgs?.targetSlideNumber,\n        callArgs?.target_slide_number,\n      );\n    }\n  }\n  if (!assetId) return;\n  openAutomatically({ assetId, tool, spec, slideNumber });\n}\n\n/**\n * Default frontend tools that auto-open the asset a tool just created or\n * touched: each tool with a spec, and every studio script (`PTC_PARENT_TOOL_NAMES`),\n * whose `Create*` sub-calls open what they made. Each only watches the call's\n * answer (`streamCall`, no `execute`): none is declared to the backend.\n * Registered automatically by `AthenaProvider` / `AthenaChat`; pass\n * `disableAutoOpen` to turn off, or override individual entries via\n * `frontendTools`.\n */\nexport const DEFAULT_AUTO_OPEN_TOOLS: Toolkit = Object.fromEntries(\n  [...new Set([...Object.keys(AUTO_OPEN_SPECS), ...PTC_PARENT_TOOL_NAMES])].map((tool): [\n    string,\n    Toolkit[string],\n  ] => [\n    tool,\n    {\n      streamCall: async (reader) => {\n        await autoOpenOnAnswer({\n          tool,\n          answer: () => reader.response.get(),\n          args: () => reader.args.get(),\n        });\n      },\n    },\n  ]),\n);\n"],"names":["tryParseJson","useAssetPanelStore","ptcSubcallsFromArtifact","PTC_PARENT_TOOL_NAMES"],"mappings":"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"}

package/dist/tools/auto-open-tools.d.ts

@@ -1,8 +1,138 @@
 import type { Toolkit } from '@assistant-ui/react';
+import { type AssetAutoOpen, type AssetType } from '../assets/asset-panel-store';
+/**
+ * The tools whose call opens the asset it names, and what each did with it: made it, opened it for
+ * the person to see, or read or changed one that was there.
+ */
+declare const AUTO_OPEN_SPECS: {
+    create_new_document: {
+        type: "document";
+        kind: "created";
+    };
+    create_document_from_markdown: {
+        type: "document";
+        kind: "created";
+    };
+    create_new_sheet: {
+        type: "spreadsheet";
+        kind: "created";
+    };
+    create_powerpoint_deck: {
+        type: "presentation";
+        kind: "created";
+    };
+    create_presentation_pptx_studio: {
+        type: "presentation";
+        kind: "created";
+    };
+    create_new_notebook: {
+        type: "notebook";
+        kind: "created";
+    };
+    open_asset_in_workspace: {
+        type: "unknown";
+        kind: "shown";
+        from: "args";
+    };
+    execute_presentation_code: {
+        type: "presentation";
+        kind: "touched";
+    };
+    capture_moment: {
+        type: "unknown";
+        kind: "created";
+    };
+    CreateWorkbook: {
+        type: "spreadsheet";
+        kind: "created";
+    };
+    AddSheet: {
+        type: "spreadsheet";
+        kind: "touched";
+    };
+    OpenWorkbook: {
+        type: "spreadsheet";
+        kind: "touched";
+    };
+    CreatePresentation: {
+        type: "presentation";
+        kind: "created";
+    };
+    OpenPresentation: {
+        type: "presentation";
+        kind: "touched";
+        preserveExistingSlide: true;
+    };
+    AddSlide: {
+        type: "presentation";
+        kind: "touched";
+    };
+    CreateDocument: {
+        type: "document";
+        kind: "created";
+    };
+    CreateParagraph: {
+        type: "document";
+        kind: "touched";
+    };
+    OpenDocument: {
+        type: "document";
+        kind: "touched";
+    };
+};
+/** The tools the SDK auto-opens after, by name. */
+export type AutoOpenTool = keyof typeof AUTO_OPEN_SPECS;
+/** An asset an agent's finished tool call made, or opened for the person to see. */
+export interface AgentCreation {
+    /** The call's own id, and a script's sub-call's after it: one creation, one key. */
+    key: string;
+    assetId: string;
+    type: AssetType;
+    /** The tool that made or showed it, and which (`created` or `shown`). */
+    autoOpen: AssetAutoOpen;
+}
+/**
+ * What one finished tool call made or showed the person, by the auto-open rules above: each asset a
+ * studio script's `Create*` sub-calls made (`studioCreations`), and the asset a create tool made or
+ * `open_asset_in_workspace` showed, unless the call's answer says it did not happen
+ * (`answerOpensNothing`). Never what a call only read or changed (`touched`).
+ */
+export declare function creationsOfCall({ toolCallId, tool, result, isError, artifact, args, }: {
+    toolCallId: string;
+    tool: string;
+    result: unknown;
+    isError?: boolean;
+    artifact?: unknown;
+    /** The call's arguments, as its AI message asked for it. */
+    args?: unknown;
+}): AgentCreation[];
+/**
+ * Opens what a default auto-open tool's call names (`DEFAULT_AUTO_OPEN_TOOLS`), once that call
+ * answered: for a studio script, each asset its `Create*` sub-calls made (`studioCreations`); then,
+ * for a tool with a spec, the id in its result (or, for `open_asset_in_workspace`, its arguments),
+ * at the slide either names. Each with what the tool did with it (`autoOpen`) for a host's opener.
+ * Nothing for a call that names no asset, one whose answer says it did not happen
+ * (`answerOpensNothing`), or an asset already auto-opened (`markAutoOpened`).
+ */
+export declare function autoOpenOnAnswer({ tool, answer, args, }: {
+    tool: string;
+    /** The call's answer, once it came: its result, whether the call failed, and its artifact. */
+    answer: () => Promise<{
+        result: unknown;
+        isError?: boolean;
+        artifact?: unknown;
+    }>;
+    /** The call's arguments (null when they could not be read). */
+    args: () => Promise<unknown>;
+}): Promise<void>;
 /**
  * Default frontend tools that auto-open the asset a tool just created or
- * touched. Registered automatically by `AthenaProvider` / `AthenaChat`; pass
+ * touched: each tool with a spec, and every studio script (`PTC_PARENT_TOOL_NAMES`),
+ * whose `Create*` sub-calls open what they made. Each only watches the call's
+ * answer (`streamCall`, no `execute`): none is declared to the backend.
+ * Registered automatically by `AthenaProvider` / `AthenaChat`; pass
  * `disableAutoOpen` to turn off, or override individual entries via
  * `frontendTools`.
  */
 export declare const DEFAULT_AUTO_OPEN_TOOLS: Toolkit;
+export {};