@keboola/api-client 39.0.0 → 41.0.0

package/dist/kaiAgent-Dp20HLTh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kaiAgent-Dp20HLTh.js","names":[],"sources":["../src/clients/kaiAgent/kaiAgentClient.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { createGenericFetchClient, createOpenapiFetchClient, isApiError } from '../../fetchClient';\nimport { HttpStatus } from '../../internal';\nimport { createAuthHeaders } from '../auth';\nimport type { SuggestionsApiResponse, SuggestionsRequestBody } from '../chat/suggestions';\nimport type { ProjectToolPolicy, ProjectToolPolicyValue } from '../chat/types';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  ApprovalBody,\n  ArtifactListResponse,\n  ArtifactResponse,\n  ChatRequest,\n  GetArtifactPath,\n  GetArtifactsQuery,\n  GetChatPath,\n  GetHistoryQuery,\n  GetVotesQuery,\n  PrepareChatRequest,\n  UsageResponse,\n  VoteRequest,\n} from './types';\n\nconst projectToolPolicyValueSchema: z.ZodType<ProjectToolPolicyValue> = z.enum([\n  'blocked',\n  'always_ask',\n]);\n\nconst agentSettingsSchema = z.object({\n  projectId: z.string(),\n  customInstructions: z.string().nullable(),\n  toolPermissions: z.record(z.string(), projectToolPolicyValueSchema).nullable().optional(),\n  canWriteToolPolicy: z.boolean().optional(),\n  createdAt: z.string(),\n  updatedAt: z.string(),\n});\n\nconst toolPermissionValueSchema = z.enum(['always_allow', 'always_ask', 'blocked']);\n\nconst userAgentSettingsSchema = z.object({\n  projectId: z.string(),\n  userId: z.string(),\n  customInstructions: z.string().nullable(),\n  toolPermissions: z.record(z.string(), toolPermissionValueSchema).nullable(),\n  projectToolPermissions: z.record(z.string(), projectToolPolicyValueSchema).nullable().optional(),\n  createdAt: z.string(),\n  updatedAt: z.string(),\n});\n\nconst toolInfoSchema = z.object({\n  name: z.string(),\n  description: z.string(),\n  readOnly: z.boolean(),\n});\n\nconst toolsListResponseSchema = z.object({\n  tools: z.array(toolInfoSchema),\n});\n\nconst skillInfoSchema = z.object({\n  name: z.string(),\n  description: z.string().nullable(),\n  source: z.enum(['first-party', 'vendored', 'project']),\n});\n\nconst builtInCommandSchema = z.object({\n  name: z.string(),\n  description: z.string(),\n});\n\nconst skillsListResponseSchema = z.object({\n  skills: z.array(skillInfoSchema),\n  commands: z.array(builtInCommandSchema),\n});\n\nconst sandboxFileEntrySchema = z.object({\n  name: z.string(),\n  path: z.string(),\n  type: z.enum(['file', 'dir']),\n  size: z.number().int().nonnegative().optional(),\n});\n\nconst sandboxFileListingSchema = z.object({\n  entries: z.array(sandboxFileEntrySchema),\n});\n\nconst sandboxFileContentSchema = z.object({\n  content: z.string(),\n  encoding: z.enum(['utf-8', 'binary']),\n  truncated: z.boolean(),\n  size: z.number().int().nonnegative(),\n});\n\nconst sandboxGitBranchSchema = z.object({\n  branch: z.string().nullable(),\n});\n\n// `userId` only: kai-agent cannot resolve project members. Join it against\n// `api.management.projects.getProjectUsers`.\nconst spendCapMemberSchema = z.object({\n  userId: z.string(),\n  overrideLimitPpu: z.number().nullable(),\n  effectiveLimitPpu: z.number().nullable(),\n  usedPpu: z.number(),\n  overrideUpdatedAt: z.string().nullable(),\n  overrideUpdatedByUserId: z.string().nullable(),\n});\n\nconst spendCapsViewSchema = z.object({\n  // `null` = no configured cap, not unlimited — see `effectiveProjectCapPpu`.\n  projectCapPpu: z.number().nullable(),\n  // The enforced cap (`projectCapPpu` or kai-agent's DEFAULT_PROJECT_CAP_PPU).\n  // Render this; `projectCapPpu` only tells configured from default.\n  effectiveProjectCapPpu: z.number(),\n  // Platform default regardless of what's saved; validates a cleared-but-unsaved field.\n  // Optional on the wire (rollout skew); `withDefaultProjectCap` fills it in.\n  defaultProjectCapPpu: z.number().optional(),\n  defaultUserLimitPpu: z.number().nullable(),\n  projectUsedPpu: z.number(),\n  canWrite: z.boolean(),\n  members: z.array(spendCapMemberSchema),\n  updatedAt: z.string().nullable(),\n  updatedByUserId: z.string().nullable(),\n});\n\nconst votesResponseSchema = z.array(\n  z.object({\n    chatId: z.string(),\n    messageId: z.string(),\n    isUpvoted: z.boolean(),\n  }),\n);\n\nexport type SpendCapMember = z.infer<typeof spendCapMemberSchema>;\n// `defaultProjectCapPpu` is always present here — `getSpendCaps`/`updateSpendCaps` fill it in.\nexport type SpendCapsView = Omit<z.infer<typeof spendCapsViewSchema>, 'defaultProjectCapPpu'> & {\n  defaultProjectCapPpu: number;\n};\nexport type AgentSettings = z.infer<typeof agentSettingsSchema>;\nexport type UserAgentSettings = z.infer<typeof userAgentSettingsSchema>;\ntype ToolsListResponse = z.infer<typeof toolsListResponseSchema>;\ntype SkillsListResponse = z.infer<typeof skillsListResponseSchema>;\ntype SandboxFileListing = z.infer<typeof sandboxFileListingSchema>;\ntype SandboxFileContent = z.infer<typeof sandboxFileContentSchema>;\ntype SandboxGitBranch = z.infer<typeof sandboxGitBranchSchema>;\ntype VotesResponse = z.infer<typeof votesResponseSchema>;\n\ntype UpdateAgentSettingsRequest = {\n  customInstructions?: string | null;\n};\n\ntype UpdateUserAgentSettingsRequest = {\n  customInstructions?: string | null;\n  toolPermissions?: Record<string, z.infer<typeof toolPermissionValueSchema>> | null;\n};\n\ntype UpdateSpendCapsRequest = {\n  projectCapPpu?: number | null;\n  defaultUserLimitPpu?: number | null;\n};\n\nexport const createKaiAgentClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const clientOptions = {\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  };\n\n  const client = createOpenapiFetchClient<paths>(clientOptions);\n  const genericClient = createGenericFetchClient(clientOptions);\n\n  const getHistory = async (params?: GetHistoryQuery, signal?: AbortSignal) => {\n    const { data } = await client.get('/api/history', { query: params }, { signal });\n    return data;\n  };\n\n  const getChat = async (chatId: GetChatPath['id'], signal?: AbortSignal) => {\n    const { data } = await client.get('/api/chat/{id}', { path: { id: chatId } }, { signal });\n    return data;\n  };\n\n  const deleteChat = async (chatId: string) => {\n    const { data } = await client.delete('/api/chat', { query: { id: chatId } });\n    return data;\n  };\n\n  const createChat = async (request: ChatRequest) => {\n    const { response } = await client.post('/api/chat', { body: request });\n    return response;\n  };\n\n  const getVotes = async (chatId: GetVotesQuery['chatId']): Promise<VotesResponse> => {\n    const { data } = await client.get('/api/vote', { query: { chatId } });\n\n    const result = votesResponseSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid votes response format');\n    }\n\n    return result.data;\n  };\n\n  const submitVote = async (params: VoteRequest) => {\n    await client.patch('/api/vote', { body: params });\n  };\n\n  /**\n   * Every artifact a chat produced, oldest first.\n   *\n   * - Read-only by design: artifacts are derived server-side at the end of a turn, so there is\n   *   no write route to pair with this.\n   * - The chat is the authorization — a chat the caller cannot read has no artifacts.\n   */\n  const getArtifacts = async (\n    chatId: GetArtifactsQuery['chatId'],\n    signal?: AbortSignal,\n  ): Promise<ArtifactListResponse> => {\n    const { data } = await client.get('/api/artifacts', { query: { chatId } }, { signal });\n    return data;\n  };\n\n  const getArtifact = async (\n    artifactId: GetArtifactPath['id'],\n    signal?: AbortSignal,\n  ): Promise<ArtifactResponse> => {\n    const { data } = await client.get(\n      '/api/artifacts/{id}',\n      { path: { id: artifactId } },\n      {\n        signal,\n      },\n    );\n    return data;\n  };\n\n  const getUsage = async (signal?: AbortSignal): Promise<UsageResponse> => {\n    const { data } = await client.get('/api/usage', {}, { signal });\n    // `freeAllowance` is ahead of the generated schema — a guard turns a missing field into `null`.\n    const parsed = z\n      .object({\n        freeAllowance: z\n          .object({ grantedPpu: z.number(), remainingPpu: z.number() })\n          .nullable()\n          .optional(),\n      })\n      .safeParse(data);\n    const freeAllowance = parsed.success ? (parsed.data.freeAllowance ?? null) : null;\n    return { ...data, freeAllowance };\n  };\n\n  const approveToolCall = async (chatId: string, body: ApprovalBody): Promise<void> => {\n    await client.post('/api/chat/{id}/approval', { path: { id: chatId }, body });\n  };\n\n  const submitToolOutput = async (\n    chatId: string,\n    body: { toolUseId: string; output?: string; errorText?: string },\n  ): Promise<void> => {\n    await client.post('/api/chat/{id}/ui-tool-result', { path: { id: chatId }, body });\n  };\n\n  const stopChat = async (chatId: string): Promise<{ stopped: boolean }> => {\n    const { data } = await client.post('/api/chat/{id}/stop', { path: { id: chatId } });\n    return data;\n  };\n\n  /**\n   * Ask the engine to build this chat's sandbox before a turn needs one.\n   *\n   * - The work continues after the response.\n   * - A host that does not pre-warm answers 404, returned as `{ started: false }`.\n   */\n  const prepareChat = async (\n    chatId: string,\n    signal?: AbortSignal,\n    body: PrepareChatRequest = {},\n  ): Promise<{ started: boolean }> => {\n    try {\n      const { data } = await client.post(\n        '/api/chat/{id}/prepare',\n        { path: { id: chatId }, body },\n        { signal },\n      );\n      return data;\n    } catch (error) {\n      // 404 = pre-warm not supported here.\n      if (isApiError(error) && error.response.status === HttpStatus.NOT_FOUND) {\n        return { started: false };\n      }\n      throw error;\n    }\n  };\n\n  const getSuggestions = async (\n    request: SuggestionsRequestBody,\n    signal?: AbortSignal,\n  ): Promise<SuggestionsApiResponse> => {\n    const { data } = await client.post('/api/suggestions', { body: request }, { signal });\n    return data;\n  };\n\n  const getAgentSettings = async (signal?: AbortSignal): Promise<AgentSettings> => {\n    const { data } = await genericClient.get<AgentSettings>('/api/settings', {}, { signal });\n    const result = agentSettingsSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid agent settings response format');\n    }\n    return result.data;\n  };\n\n  const updateAgentSettings = async (\n    request: UpdateAgentSettingsRequest,\n    signal?: AbortSignal,\n  ): Promise<AgentSettings> => {\n    const { data } = await genericClient.patch<AgentSettings>(\n      '/api/settings',\n      { body: request },\n      { signal },\n    );\n    const result = agentSettingsSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid agent settings response format');\n    }\n    return result.data;\n  };\n\n  const updateProjectToolPolicy = async (\n    toolPermissions: ProjectToolPolicy,\n    signal?: AbortSignal,\n  ): Promise<AgentSettings> => {\n    const { data } = await genericClient.put<AgentSettings>(\n      '/api/settings/tool-permissions',\n      { body: { toolPermissions } },\n      { signal },\n    );\n    const result = agentSettingsSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid agent settings response format');\n    }\n    return result.data;\n  };\n\n  const getUserAgentSettings = async (signal?: AbortSignal): Promise<UserAgentSettings> => {\n    const { data } = await genericClient.get<UserAgentSettings>(\n      '/api/settings/user',\n      {},\n      { signal },\n    );\n    const result = userAgentSettingsSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid user agent settings response format');\n    }\n    return result.data;\n  };\n\n  const updateUserAgentSettings = async (\n    request: UpdateUserAgentSettingsRequest,\n    signal?: AbortSignal,\n  ): Promise<UserAgentSettings> => {\n    const { data } = await genericClient.patch<UserAgentSettings>(\n      '/api/settings/user',\n      { body: request },\n      { signal },\n    );\n    const result = userAgentSettingsSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid user agent settings response format');\n    }\n    return result.data;\n  };\n\n  // An older kai-agent omits `defaultProjectCapPpu`; fall back rather than throw.\n  const withDefaultProjectCap = (view: z.infer<typeof spendCapsViewSchema>): SpendCapsView => ({\n    ...view,\n    defaultProjectCapPpu: view.defaultProjectCapPpu ?? view.effectiveProjectCapPpu,\n  });\n\n  // Not in `__generated__/schema` yet (see docs/regenerate-api-types.md), hence `genericClient`\n  // + zod. Switch to `client.get('/api/settings/spend-caps')` once it regenerates.\n  const getSpendCaps = async (signal?: AbortSignal): Promise<SpendCapsView> => {\n    const { data } = await genericClient.get<SpendCapsView>(\n      '/api/settings/spend-caps',\n      {},\n      { signal },\n    );\n    const result = spendCapsViewSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid spend caps response format');\n    }\n    return withDefaultProjectCap(result.data);\n  };\n\n  const updateSpendCaps = async (\n    request: UpdateSpendCapsRequest,\n    signal?: AbortSignal,\n  ): Promise<SpendCapsView> => {\n    const { data } = await genericClient.patch<SpendCapsView>(\n      '/api/settings/spend-caps',\n      { body: request },\n      { signal },\n    );\n    const result = spendCapsViewSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid spend caps response format');\n    }\n    return withDefaultProjectCap(result.data);\n  };\n\n  const setUserSpendLimit = async (\n    userId: string,\n    overrideLimitPpu: number | null,\n    signal?: AbortSignal,\n  ): Promise<SpendCapMember> => {\n    const { data } = await genericClient.put<SpendCapMember>(\n      `/api/settings/spend-caps/users/${encodeURIComponent(userId)}`,\n      { body: { overrideLimitPpu } },\n      { signal },\n    );\n    const result = spendCapMemberSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid spend cap member response format');\n    }\n    return result.data;\n  };\n\n  const getToolsList = async (signal?: AbortSignal): Promise<ToolsListResponse> => {\n    const { data } = await genericClient.get<ToolsListResponse>(\n      '/api/settings/tools',\n      {},\n      { signal },\n    );\n    const result = toolsListResponseSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid tools list response format');\n    }\n    return result.data;\n  };\n\n  const getSkillsList = async (signal?: AbortSignal): Promise<SkillsListResponse> => {\n    const { data } = await genericClient.get<SkillsListResponse>('/api/skills', {}, { signal });\n    const result = skillsListResponseSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid skills list response format');\n    }\n    return result.data;\n  };\n\n  const listSandboxFiles = async (\n    chatId: string,\n    path?: string,\n    signal?: AbortSignal,\n  ): Promise<SandboxFileListing> => {\n    const { data } = await genericClient.get<SandboxFileListing>(\n      `/api/chat/${encodeURIComponent(chatId)}/sandbox/files`,\n      { query: path ? { path } : undefined },\n      { signal },\n    );\n    const result = sandboxFileListingSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid sandbox files response format');\n    }\n    return result.data;\n  };\n\n  const readSandboxFile = async (\n    chatId: string,\n    path: string,\n    signal?: AbortSignal,\n  ): Promise<SandboxFileContent> => {\n    const { data } = await genericClient.get<SandboxFileContent>(\n      `/api/chat/${encodeURIComponent(chatId)}/sandbox/file`,\n      { query: { path } },\n      { signal },\n    );\n    const result = sandboxFileContentSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid sandbox file response format');\n    }\n    return result.data;\n  };\n\n  const downloadSandboxFile = async (\n    chatId: string,\n    path: string,\n    signal?: AbortSignal,\n  ): Promise<Blob> => {\n    // `parseData` returns a declared octet-stream body as a Blob, bytes intact.\n    const { data } = await genericClient.get<Blob>(\n      `/api/chat/${encodeURIComponent(chatId)}/sandbox/file/download`,\n      { query: { path } },\n      { signal },\n    );\n    if (!(data instanceof Blob)) {\n      throw new Error('Invalid sandbox file download response format');\n    }\n    return data;\n  };\n\n  const getSandboxGitBranch = async (\n    chatId: string,\n    signal?: AbortSignal,\n  ): Promise<SandboxGitBranch> => {\n    const { data } = await genericClient.get<SandboxGitBranch>(\n      `/api/chat/${encodeURIComponent(chatId)}/sandbox/git-branch`,\n      {},\n      { signal },\n    );\n    const result = sandboxGitBranchSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid sandbox git-branch response format');\n    }\n    return result.data;\n  };\n\n  const chatStreamUrl = clientOptions.baseUrl + '/api/chat';\n\n  // `/health`, not `/ping`: it returns `{\"status\":\"ok\"}` like other services, not a timestamp.\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await genericClient.get('/health', {}, { signal });\n\n    return data;\n  };\n\n  return {\n    healthCheck,\n    getHistory,\n    getChat,\n    deleteChat,\n    createChat,\n    getVotes,\n    submitVote,\n    getUsage,\n    getArtifacts,\n    getArtifact,\n    approveToolCall,\n    submitToolOutput,\n    stopChat,\n    prepareChat,\n    getSuggestions,\n    getAgentSettings,\n    updateAgentSettings,\n    updateProjectToolPolicy,\n    getUserAgentSettings,\n    updateUserAgentSettings,\n    getSpendCaps,\n    updateSpendCaps,\n    setUserSpendLimit,\n    getToolsList,\n    getSkillsList,\n    listSandboxFiles,\n    readSandboxFile,\n    downloadSandboxFile,\n    getSandboxGitBranch,\n    chatStreamUrl,\n  };\n};\n"],"mappings":"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"}

package/dist/{kaiAgent-DaB6UCsh.cjs → kaiAgent-QNoeVKPs.cjs}

@@ -1,12 +1,15 @@
-const require_createFetchClient = require("./createFetchClient-BlgPbjFj.cjs");
-const require_createGenericFetchClient = require("./createGenericFetchClient-lcozzwk2.cjs");
-const require_createOpenapiFetchClient = require("./createOpenapiFetchClient-C3UmDXpe.cjs");
-const require_auth = require("./auth-DLWnl18b.cjs");
+const require_createFetchClient = require("./createFetchClient-Cwp8max9.cjs");
+const require_createGenericFetchClient = require("./createGenericFetchClient-Dl9cqTvR.cjs");
+const require_createOpenapiFetchClient = require("./createOpenapiFetchClient-BYqW-9tm.cjs");
+const require_auth = require("./auth-Dm0F2rOh.cjs");
 let zod = require("zod");
 //#region src/clients/kaiAgent/kaiAgentClient.ts
+const projectToolPolicyValueSchema = zod.z.enum(["blocked", "always_ask"]);
 const agentSettingsSchema = zod.z.object({
 	projectId: zod.z.string(),
 	customInstructions: zod.z.string().nullable(),
+	toolPermissions: zod.z.record(zod.z.string(), projectToolPolicyValueSchema).nullable().optional(),
+	canWriteToolPolicy: zod.z.boolean().optional(),
 	createdAt: zod.z.string(),
 	updatedAt: zod.z.string()
 });
@@ -20,6 +23,7 @@ const userAgentSettingsSchema = zod.z.object({
 	userId: zod.z.string(),
 	customInstructions: zod.z.string().nullable(),
 	toolPermissions: zod.z.record(zod.z.string(), toolPermissionValueSchema).nullable(),
+	projectToolPermissions: zod.z.record(zod.z.string(), projectToolPolicyValueSchema).nullable().optional(),
 	createdAt: zod.z.string(),
 	updatedAt: zod.z.string()
 });
@@ -134,7 +138,15 @@ const createKaiAgentClient = ({ baseUrl, middlewares, auth }) => {
 	};
 	const getUsage = async (signal) => {
 		const { data } = await client.get("/api/usage", {}, { signal });
-		return data;
+		const parsed = zod.z.object({ freeAllowance: zod.z.object({
+			grantedPpu: zod.z.number(),
+			remainingPpu: zod.z.number()
+		}).nullable().optional() }).safeParse(data);
+		const freeAllowance = parsed.success ? parsed.data.freeAllowance ?? null : null;
+		return {
+			...data,
+			freeAllowance
+		};
 	};
 	const approveToolCall = async (chatId, body) => {
 		await client.post("/api/chat/{id}/approval", {
@@ -155,13 +167,15 @@ const createKaiAgentClient = ({ baseUrl, middlewares, auth }) => {
 	/**
 	* Ask the engine to build this chat's sandbox before a turn needs one.
 	*
-	* Speculative: the work continues after the response, and a deployment whose
-	* host does not pre-warm answers 404, which callers should read as "not
-	* supported here" rather than as an error.
+	* - The work continues after the response.
+	* - A host that does not pre-warm answers 404, returned as `{ started: false }`.
 	*/
-	const prepareChat = async (chatId, signal) => {
+	const prepareChat = async (chatId, signal, body = {}) => {
 		try {
-			const { data } = await genericClient.post(`/api/chat/${encodeURIComponent(chatId)}/prepare`, {}, { signal });
+			const { data } = await client.post("/api/chat/{id}/prepare", {
+				path: { id: chatId },
+				body
+			}, { signal });
 			return data;
 		} catch (error) {
 			if (require_createFetchClient.isApiError(error) && error.response.status === require_createFetchClient.HttpStatus.NOT_FOUND) return { started: false };
@@ -184,6 +198,12 @@ const createKaiAgentClient = ({ baseUrl, middlewares, auth }) => {
 		if (!result.success) throw new Error("Invalid agent settings response format");
 		return result.data;
 	};
+	const updateProjectToolPolicy = async (toolPermissions, signal) => {
+		const { data } = await genericClient.put("/api/settings/tool-permissions", { body: { toolPermissions } }, { signal });
+		const result = agentSettingsSchema.safeParse(data);
+		if (!result.success) throw new Error("Invalid agent settings response format");
+		return result.data;
+	};
 	const getUserAgentSettings = async (signal) => {
 		const { data } = await genericClient.get("/api/settings/user", {}, { signal });
 		const result = userAgentSettingsSchema.safeParse(data);
@@ -276,6 +296,7 @@ const createKaiAgentClient = ({ baseUrl, middlewares, auth }) => {
 		getSuggestions,
 		getAgentSettings,
 		updateAgentSettings,
+		updateProjectToolPolicy,
 		getUserAgentSettings,
 		updateUserAgentSettings,
 		getSpendCaps,
@@ -298,4 +319,4 @@ Object.defineProperty(exports, "createKaiAgentClient", {
 	}
 });
 
-//# sourceMappingURL=kaiAgent-DaB6UCsh.cjs.map
+//# sourceMappingURL=kaiAgent-QNoeVKPs.cjs.map

package/dist/kaiAgent-QNoeVKPs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kaiAgent-QNoeVKPs.cjs","names":["z","createAuthHeaders","createOpenapiFetchClient","createGenericFetchClient","isApiError","HttpStatus"],"sources":["../src/clients/kaiAgent/kaiAgentClient.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { createGenericFetchClient, createOpenapiFetchClient, isApiError } from '../../fetchClient';\nimport { HttpStatus } from '../../internal';\nimport { createAuthHeaders } from '../auth';\nimport type { SuggestionsApiResponse, SuggestionsRequestBody } from '../chat/suggestions';\nimport type { ProjectToolPolicy, ProjectToolPolicyValue } from '../chat/types';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  ApprovalBody,\n  ArtifactListResponse,\n  ArtifactResponse,\n  ChatRequest,\n  GetArtifactPath,\n  GetArtifactsQuery,\n  GetChatPath,\n  GetHistoryQuery,\n  GetVotesQuery,\n  PrepareChatRequest,\n  UsageResponse,\n  VoteRequest,\n} from './types';\n\nconst projectToolPolicyValueSchema: z.ZodType<ProjectToolPolicyValue> = z.enum([\n  'blocked',\n  'always_ask',\n]);\n\nconst agentSettingsSchema = z.object({\n  projectId: z.string(),\n  customInstructions: z.string().nullable(),\n  toolPermissions: z.record(z.string(), projectToolPolicyValueSchema).nullable().optional(),\n  canWriteToolPolicy: z.boolean().optional(),\n  createdAt: z.string(),\n  updatedAt: z.string(),\n});\n\nconst toolPermissionValueSchema = z.enum(['always_allow', 'always_ask', 'blocked']);\n\nconst userAgentSettingsSchema = z.object({\n  projectId: z.string(),\n  userId: z.string(),\n  customInstructions: z.string().nullable(),\n  toolPermissions: z.record(z.string(), toolPermissionValueSchema).nullable(),\n  projectToolPermissions: z.record(z.string(), projectToolPolicyValueSchema).nullable().optional(),\n  createdAt: z.string(),\n  updatedAt: z.string(),\n});\n\nconst toolInfoSchema = z.object({\n  name: z.string(),\n  description: z.string(),\n  readOnly: z.boolean(),\n});\n\nconst toolsListResponseSchema = z.object({\n  tools: z.array(toolInfoSchema),\n});\n\nconst skillInfoSchema = z.object({\n  name: z.string(),\n  description: z.string().nullable(),\n  source: z.enum(['first-party', 'vendored', 'project']),\n});\n\nconst builtInCommandSchema = z.object({\n  name: z.string(),\n  description: z.string(),\n});\n\nconst skillsListResponseSchema = z.object({\n  skills: z.array(skillInfoSchema),\n  commands: z.array(builtInCommandSchema),\n});\n\nconst sandboxFileEntrySchema = z.object({\n  name: z.string(),\n  path: z.string(),\n  type: z.enum(['file', 'dir']),\n  size: z.number().int().nonnegative().optional(),\n});\n\nconst sandboxFileListingSchema = z.object({\n  entries: z.array(sandboxFileEntrySchema),\n});\n\nconst sandboxFileContentSchema = z.object({\n  content: z.string(),\n  encoding: z.enum(['utf-8', 'binary']),\n  truncated: z.boolean(),\n  size: z.number().int().nonnegative(),\n});\n\nconst sandboxGitBranchSchema = z.object({\n  branch: z.string().nullable(),\n});\n\n// `userId` only: kai-agent cannot resolve project members. Join it against\n// `api.management.projects.getProjectUsers`.\nconst spendCapMemberSchema = z.object({\n  userId: z.string(),\n  overrideLimitPpu: z.number().nullable(),\n  effectiveLimitPpu: z.number().nullable(),\n  usedPpu: z.number(),\n  overrideUpdatedAt: z.string().nullable(),\n  overrideUpdatedByUserId: z.string().nullable(),\n});\n\nconst spendCapsViewSchema = z.object({\n  // `null` = no configured cap, not unlimited — see `effectiveProjectCapPpu`.\n  projectCapPpu: z.number().nullable(),\n  // The enforced cap (`projectCapPpu` or kai-agent's DEFAULT_PROJECT_CAP_PPU).\n  // Render this; `projectCapPpu` only tells configured from default.\n  effectiveProjectCapPpu: z.number(),\n  // Platform default regardless of what's saved; validates a cleared-but-unsaved field.\n  // Optional on the wire (rollout skew); `withDefaultProjectCap` fills it in.\n  defaultProjectCapPpu: z.number().optional(),\n  defaultUserLimitPpu: z.number().nullable(),\n  projectUsedPpu: z.number(),\n  canWrite: z.boolean(),\n  members: z.array(spendCapMemberSchema),\n  updatedAt: z.string().nullable(),\n  updatedByUserId: z.string().nullable(),\n});\n\nconst votesResponseSchema = z.array(\n  z.object({\n    chatId: z.string(),\n    messageId: z.string(),\n    isUpvoted: z.boolean(),\n  }),\n);\n\nexport type SpendCapMember = z.infer<typeof spendCapMemberSchema>;\n// `defaultProjectCapPpu` is always present here — `getSpendCaps`/`updateSpendCaps` fill it in.\nexport type SpendCapsView = Omit<z.infer<typeof spendCapsViewSchema>, 'defaultProjectCapPpu'> & {\n  defaultProjectCapPpu: number;\n};\nexport type AgentSettings = z.infer<typeof agentSettingsSchema>;\nexport type UserAgentSettings = z.infer<typeof userAgentSettingsSchema>;\ntype ToolsListResponse = z.infer<typeof toolsListResponseSchema>;\ntype SkillsListResponse = z.infer<typeof skillsListResponseSchema>;\ntype SandboxFileListing = z.infer<typeof sandboxFileListingSchema>;\ntype SandboxFileContent = z.infer<typeof sandboxFileContentSchema>;\ntype SandboxGitBranch = z.infer<typeof sandboxGitBranchSchema>;\ntype VotesResponse = z.infer<typeof votesResponseSchema>;\n\ntype UpdateAgentSettingsRequest = {\n  customInstructions?: string | null;\n};\n\ntype UpdateUserAgentSettingsRequest = {\n  customInstructions?: string | null;\n  toolPermissions?: Record<string, z.infer<typeof toolPermissionValueSchema>> | null;\n};\n\ntype UpdateSpendCapsRequest = {\n  projectCapPpu?: number | null;\n  defaultUserLimitPpu?: number | null;\n};\n\nexport const createKaiAgentClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const clientOptions = {\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  };\n\n  const client = createOpenapiFetchClient<paths>(clientOptions);\n  const genericClient = createGenericFetchClient(clientOptions);\n\n  const getHistory = async (params?: GetHistoryQuery, signal?: AbortSignal) => {\n    const { data } = await client.get('/api/history', { query: params }, { signal });\n    return data;\n  };\n\n  const getChat = async (chatId: GetChatPath['id'], signal?: AbortSignal) => {\n    const { data } = await client.get('/api/chat/{id}', { path: { id: chatId } }, { signal });\n    return data;\n  };\n\n  const deleteChat = async (chatId: string) => {\n    const { data } = await client.delete('/api/chat', { query: { id: chatId } });\n    return data;\n  };\n\n  const createChat = async (request: ChatRequest) => {\n    const { response } = await client.post('/api/chat', { body: request });\n    return response;\n  };\n\n  const getVotes = async (chatId: GetVotesQuery['chatId']): Promise<VotesResponse> => {\n    const { data } = await client.get('/api/vote', { query: { chatId } });\n\n    const result = votesResponseSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid votes response format');\n    }\n\n    return result.data;\n  };\n\n  const submitVote = async (params: VoteRequest) => {\n    await client.patch('/api/vote', { body: params });\n  };\n\n  /**\n   * Every artifact a chat produced, oldest first.\n   *\n   * - Read-only by design: artifacts are derived server-side at the end of a turn, so there is\n   *   no write route to pair with this.\n   * - The chat is the authorization — a chat the caller cannot read has no artifacts.\n   */\n  const getArtifacts = async (\n    chatId: GetArtifactsQuery['chatId'],\n    signal?: AbortSignal,\n  ): Promise<ArtifactListResponse> => {\n    const { data } = await client.get('/api/artifacts', { query: { chatId } }, { signal });\n    return data;\n  };\n\n  const getArtifact = async (\n    artifactId: GetArtifactPath['id'],\n    signal?: AbortSignal,\n  ): Promise<ArtifactResponse> => {\n    const { data } = await client.get(\n      '/api/artifacts/{id}',\n      { path: { id: artifactId } },\n      {\n        signal,\n      },\n    );\n    return data;\n  };\n\n  const getUsage = async (signal?: AbortSignal): Promise<UsageResponse> => {\n    const { data } = await client.get('/api/usage', {}, { signal });\n    // `freeAllowance` is ahead of the generated schema — a guard turns a missing field into `null`.\n    const parsed = z\n      .object({\n        freeAllowance: z\n          .object({ grantedPpu: z.number(), remainingPpu: z.number() })\n          .nullable()\n          .optional(),\n      })\n      .safeParse(data);\n    const freeAllowance = parsed.success ? (parsed.data.freeAllowance ?? null) : null;\n    return { ...data, freeAllowance };\n  };\n\n  const approveToolCall = async (chatId: string, body: ApprovalBody): Promise<void> => {\n    await client.post('/api/chat/{id}/approval', { path: { id: chatId }, body });\n  };\n\n  const submitToolOutput = async (\n    chatId: string,\n    body: { toolUseId: string; output?: string; errorText?: string },\n  ): Promise<void> => {\n    await client.post('/api/chat/{id}/ui-tool-result', { path: { id: chatId }, body });\n  };\n\n  const stopChat = async (chatId: string): Promise<{ stopped: boolean }> => {\n    const { data } = await client.post('/api/chat/{id}/stop', { path: { id: chatId } });\n    return data;\n  };\n\n  /**\n   * Ask the engine to build this chat's sandbox before a turn needs one.\n   *\n   * - The work continues after the response.\n   * - A host that does not pre-warm answers 404, returned as `{ started: false }`.\n   */\n  const prepareChat = async (\n    chatId: string,\n    signal?: AbortSignal,\n    body: PrepareChatRequest = {},\n  ): Promise<{ started: boolean }> => {\n    try {\n      const { data } = await client.post(\n        '/api/chat/{id}/prepare',\n        { path: { id: chatId }, body },\n        { signal },\n      );\n      return data;\n    } catch (error) {\n      // 404 = pre-warm not supported here.\n      if (isApiError(error) && error.response.status === HttpStatus.NOT_FOUND) {\n        return { started: false };\n      }\n      throw error;\n    }\n  };\n\n  const getSuggestions = async (\n    request: SuggestionsRequestBody,\n    signal?: AbortSignal,\n  ): Promise<SuggestionsApiResponse> => {\n    const { data } = await client.post('/api/suggestions', { body: request }, { signal });\n    return data;\n  };\n\n  const getAgentSettings = async (signal?: AbortSignal): Promise<AgentSettings> => {\n    const { data } = await genericClient.get<AgentSettings>('/api/settings', {}, { signal });\n    const result = agentSettingsSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid agent settings response format');\n    }\n    return result.data;\n  };\n\n  const updateAgentSettings = async (\n    request: UpdateAgentSettingsRequest,\n    signal?: AbortSignal,\n  ): Promise<AgentSettings> => {\n    const { data } = await genericClient.patch<AgentSettings>(\n      '/api/settings',\n      { body: request },\n      { signal },\n    );\n    const result = agentSettingsSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid agent settings response format');\n    }\n    return result.data;\n  };\n\n  const updateProjectToolPolicy = async (\n    toolPermissions: ProjectToolPolicy,\n    signal?: AbortSignal,\n  ): Promise<AgentSettings> => {\n    const { data } = await genericClient.put<AgentSettings>(\n      '/api/settings/tool-permissions',\n      { body: { toolPermissions } },\n      { signal },\n    );\n    const result = agentSettingsSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid agent settings response format');\n    }\n    return result.data;\n  };\n\n  const getUserAgentSettings = async (signal?: AbortSignal): Promise<UserAgentSettings> => {\n    const { data } = await genericClient.get<UserAgentSettings>(\n      '/api/settings/user',\n      {},\n      { signal },\n    );\n    const result = userAgentSettingsSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid user agent settings response format');\n    }\n    return result.data;\n  };\n\n  const updateUserAgentSettings = async (\n    request: UpdateUserAgentSettingsRequest,\n    signal?: AbortSignal,\n  ): Promise<UserAgentSettings> => {\n    const { data } = await genericClient.patch<UserAgentSettings>(\n      '/api/settings/user',\n      { body: request },\n      { signal },\n    );\n    const result = userAgentSettingsSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid user agent settings response format');\n    }\n    return result.data;\n  };\n\n  // An older kai-agent omits `defaultProjectCapPpu`; fall back rather than throw.\n  const withDefaultProjectCap = (view: z.infer<typeof spendCapsViewSchema>): SpendCapsView => ({\n    ...view,\n    defaultProjectCapPpu: view.defaultProjectCapPpu ?? view.effectiveProjectCapPpu,\n  });\n\n  // Not in `__generated__/schema` yet (see docs/regenerate-api-types.md), hence `genericClient`\n  // + zod. Switch to `client.get('/api/settings/spend-caps')` once it regenerates.\n  const getSpendCaps = async (signal?: AbortSignal): Promise<SpendCapsView> => {\n    const { data } = await genericClient.get<SpendCapsView>(\n      '/api/settings/spend-caps',\n      {},\n      { signal },\n    );\n    const result = spendCapsViewSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid spend caps response format');\n    }\n    return withDefaultProjectCap(result.data);\n  };\n\n  const updateSpendCaps = async (\n    request: UpdateSpendCapsRequest,\n    signal?: AbortSignal,\n  ): Promise<SpendCapsView> => {\n    const { data } = await genericClient.patch<SpendCapsView>(\n      '/api/settings/spend-caps',\n      { body: request },\n      { signal },\n    );\n    const result = spendCapsViewSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid spend caps response format');\n    }\n    return withDefaultProjectCap(result.data);\n  };\n\n  const setUserSpendLimit = async (\n    userId: string,\n    overrideLimitPpu: number | null,\n    signal?: AbortSignal,\n  ): Promise<SpendCapMember> => {\n    const { data } = await genericClient.put<SpendCapMember>(\n      `/api/settings/spend-caps/users/${encodeURIComponent(userId)}`,\n      { body: { overrideLimitPpu } },\n      { signal },\n    );\n    const result = spendCapMemberSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid spend cap member response format');\n    }\n    return result.data;\n  };\n\n  const getToolsList = async (signal?: AbortSignal): Promise<ToolsListResponse> => {\n    const { data } = await genericClient.get<ToolsListResponse>(\n      '/api/settings/tools',\n      {},\n      { signal },\n    );\n    const result = toolsListResponseSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid tools list response format');\n    }\n    return result.data;\n  };\n\n  const getSkillsList = async (signal?: AbortSignal): Promise<SkillsListResponse> => {\n    const { data } = await genericClient.get<SkillsListResponse>('/api/skills', {}, { signal });\n    const result = skillsListResponseSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid skills list response format');\n    }\n    return result.data;\n  };\n\n  const listSandboxFiles = async (\n    chatId: string,\n    path?: string,\n    signal?: AbortSignal,\n  ): Promise<SandboxFileListing> => {\n    const { data } = await genericClient.get<SandboxFileListing>(\n      `/api/chat/${encodeURIComponent(chatId)}/sandbox/files`,\n      { query: path ? { path } : undefined },\n      { signal },\n    );\n    const result = sandboxFileListingSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid sandbox files response format');\n    }\n    return result.data;\n  };\n\n  const readSandboxFile = async (\n    chatId: string,\n    path: string,\n    signal?: AbortSignal,\n  ): Promise<SandboxFileContent> => {\n    const { data } = await genericClient.get<SandboxFileContent>(\n      `/api/chat/${encodeURIComponent(chatId)}/sandbox/file`,\n      { query: { path } },\n      { signal },\n    );\n    const result = sandboxFileContentSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid sandbox file response format');\n    }\n    return result.data;\n  };\n\n  const downloadSandboxFile = async (\n    chatId: string,\n    path: string,\n    signal?: AbortSignal,\n  ): Promise<Blob> => {\n    // `parseData` returns a declared octet-stream body as a Blob, bytes intact.\n    const { data } = await genericClient.get<Blob>(\n      `/api/chat/${encodeURIComponent(chatId)}/sandbox/file/download`,\n      { query: { path } },\n      { signal },\n    );\n    if (!(data instanceof Blob)) {\n      throw new Error('Invalid sandbox file download response format');\n    }\n    return data;\n  };\n\n  const getSandboxGitBranch = async (\n    chatId: string,\n    signal?: AbortSignal,\n  ): Promise<SandboxGitBranch> => {\n    const { data } = await genericClient.get<SandboxGitBranch>(\n      `/api/chat/${encodeURIComponent(chatId)}/sandbox/git-branch`,\n      {},\n      { signal },\n    );\n    const result = sandboxGitBranchSchema.safeParse(data);\n    if (!result.success) {\n      throw new Error('Invalid sandbox git-branch response format');\n    }\n    return result.data;\n  };\n\n  const chatStreamUrl = clientOptions.baseUrl + '/api/chat';\n\n  // `/health`, not `/ping`: it returns `{\"status\":\"ok\"}` like other services, not a timestamp.\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await genericClient.get('/health', {}, { signal });\n\n    return data;\n  };\n\n  return {\n    healthCheck,\n    getHistory,\n    getChat,\n    deleteChat,\n    createChat,\n    getVotes,\n    submitVote,\n    getUsage,\n    getArtifacts,\n    getArtifact,\n    approveToolCall,\n    submitToolOutput,\n    stopChat,\n    prepareChat,\n    getSuggestions,\n    getAgentSettings,\n    updateAgentSettings,\n    updateProjectToolPolicy,\n    getUserAgentSettings,\n    updateUserAgentSettings,\n    getSpendCaps,\n    updateSpendCaps,\n    setUserSpendLimit,\n    getToolsList,\n    getSkillsList,\n    listSandboxFiles,\n    readSandboxFile,\n    downloadSandboxFile,\n    getSandboxGitBranch,\n    chatStreamUrl,\n  };\n};\n"],"mappings":"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"}

package/dist/kaiMemory-CClSPInt.cjs

@@ -0,0 +1,289 @@
+const require_createFetchClient = require("./createFetchClient-Cwp8max9.cjs");
+const require_ValidationError = require("./ValidationError-D65QU0uq.cjs");
+let zod = require("zod");
+//#region src/sdks/kaiMemory/vocabulary.ts
+/**
+* The closed value set a `kai-memory` object's `status` accepts.
+*
+* A single runtime source for the union in `./types`, mirroring
+* `sdks/semanticLayer/vocabulary.ts`'s pattern — a value cannot exist in the type and be
+* missing from the list a validator or a UI dropdown is built from.
+*/
+const KAI_MEMORY_STATUSES = [
+	"pending",
+	"approved",
+	"rejected"
+];
+//#endregion
+//#region src/sdks/kaiMemory/readSchemas.ts
+/**
+* What a read of the metastore is allowed to hand back for a `kai-memory` object — see
+* `sdks/semanticLayer/readSchemas.ts` for the `looseObject` reasoning this mirrors.
+*
+* `status` drops as unrecognized rather than passing through: an item this SDK cannot classify
+* as pending/approved/rejected must never be treated as any of them, in particular `approved`.
+*/
+const kaiMemoryReadSchema = zod.z.looseObject({
+	content: zod.z.string(),
+	status: zod.z.enum(KAI_MEMORY_STATUSES),
+	chatId: zod.z.string(),
+	createdBy: zod.z.string().optional()
+});
+const kaiMemoryMetaSchema = zod.z.looseObject({
+	name: zod.z.string().optional(),
+	branch: zod.z.string().optional(),
+	projectId: zod.z.number().optional(),
+	organizationId: zod.z.string().optional(),
+	revision: zod.z.number().optional(),
+	schemaVersion: zod.z.string().optional(),
+	createdAt: zod.z.string().optional(),
+	lastUpdated: zod.z.string().optional(),
+	revisionCreatedAt: zod.z.string().optional()
+});
+/**
+* The envelope every read comes wrapped in, mapped to the `KaiMemoryItem` the SDK returns. `meta`
+* absent or `null` both normalize to `{}` — see `semanticObjectReadSchema` for why an envelope
+* omitting audit fields is a normalization, not a failure.
+*/
+const kaiMemoryItemReadSchema = zod.z.object({
+	id: zod.z.string(),
+	attributes: kaiMemoryReadSchema,
+	meta: kaiMemoryMetaSchema.nullish()
+}).transform(({ id, attributes, meta }) => ({
+	uuid: id,
+	data: attributes,
+	meta: meta ?? {}
+}));
+//#endregion
+//#region src/sdks/kaiMemory/kaiMemorySdk.ts
+/** The metastore object type this SDK addresses — see `SEMANTIC_OBJECT_TYPE` for the convention. */
+const KAI_MEMORY_OBJECT_TYPE = "kai-memory";
+const DEFAULT_BRANCH = "main";
+const mapObject = (item) => ({
+	uuid: item.id,
+	data: item.attributes,
+	meta: item.meta
+});
+const envelopeId = (value) => {
+	if (typeof value !== "object" || value === null) return null;
+	const { id } = value;
+	return typeof id === "string" && id !== "" ? id : null;
+};
+/**
+* Thrown by `getItemsByStatusStrict` when any `kai-memory` item — of any status, not only the
+* one asked for — could not be parsed. See that function's docstring for why an unreadable item
+* anywhere in the collection fails the whole read rather than being dropped.
+*/
+var KaiMemoryUnreadableItemsError = class extends Error {
+	unreadableIds;
+	constructor(unreadableIds) {
+		super(`${unreadableIds.length} kai-memory item(s) could not be read, so the knowledge base cannot be treated as complete.`);
+		this.name = "KaiMemoryUnreadableItemsError";
+		this.unreadableIds = unreadableIds;
+	}
+};
+/**
+* Thrown by `updateStatus` when the item is no longer `pending` at write time — see that
+* function's docstring for the race it closes.
+*/
+var KaiMemoryReviewConflictError = class extends Error {
+	uuid;
+	currentStatus;
+	constructor(uuid, currentStatus) {
+		super(`This note was already reviewed (now "${currentStatus}") — refusing to overwrite a decision someone else already made.`);
+		this.name = "KaiMemoryReviewConflictError";
+		this.uuid = uuid;
+		this.currentStatus = currentStatus;
+	}
+};
+/** Shared parse loop behind `getItems` (drops and logs) and `getItemsByStatusStrict` (fails). */
+const parseObjects = (items) => {
+	const objects = [];
+	const unreadableIds = [];
+	for (const item of items) {
+		const result = kaiMemoryItemReadSchema.safeParse(item);
+		if (result.success) {
+			objects.push(result.data);
+			continue;
+		}
+		const id = envelopeId(item) ?? "<no id>";
+		unreadableIds.push(id);
+		console.warn(`kaiMemorySdk: kai-memory item "${id}" from the metastore response does not match its declared shape`, require_ValidationError.formatValidationIssues(result.error.issues));
+	}
+	return {
+		objects,
+		unreadableIds
+	};
+};
+const createKaiMemorySdk = ({ metastoreClient }) => {
+	/**
+	* The metastore's list endpoint looks up the `kai-memory` schema before querying, and 404s
+	* ("Schema not found") when it was never registered — not an empty result. Since this SDK ships
+	* independently of the backend PR that registers the schema, every read here would otherwise
+	* throw on any stack that hasn't deployed it yet (or hasn't deployed it TO yet, mid-rollout),
+	* indistinguishable from "this project genuinely has zero kai-memory items" from the caller's
+	* point of view. Treat the two the same: no schema yet means no items yet.
+	*/
+	const fetchObjects = async (signal) => {
+		let response;
+		try {
+			response = await metastoreClient.repository.getMetaObjects({ objectType: KAI_MEMORY_OBJECT_TYPE }, signal);
+		} catch (error) {
+			if (require_createFetchClient.isApiError(error) && error.response.status === require_createFetchClient.HttpStatus.NOT_FOUND) return [];
+			throw error;
+		}
+		return require_ValidationError.parseOrThrow(zod.z.array(zod.z.unknown()), response.data);
+	};
+	/**
+	* Every `kai-memory` item in the project, parsed rather than asserted.
+	*
+	* - No server-side filter (AI-3975), so a caller after one status still pays for the collection.
+	* - Degrade-on-drop: a malformed item is dropped and logged, for a display consumer (the admin
+	*   review list) that would rather show what it can. A steering-context consumer, where a
+	*   silently missing item is worse than a failed read, must use `getItemsByStatusStrict`.
+	*/
+	const getItems = async (signal) => {
+		const { objects } = parseObjects(await fetchObjects(signal));
+		return objects;
+	};
+	/** `getItems` narrowed to one status, for the admin review list. */
+	const getItemsByStatus = async (status, signal) => (await getItems(signal)).filter((item) => item.data.status === status);
+	/**
+	* `getItemsByStatus`, failing closed instead of dropping what it cannot parse.
+	*
+	* For the recall path (folded into every turn's prompt): an unclassifiable item must not be
+	* silently omitted — it might be an `approved` note vanishing with no evidence anything was
+	* missing ("steering inputs fail the turn"). Every unreadable item counts, not only ones
+	* matching `status`, since an unparsed item's real status is unknown.
+	*/
+	const getItemsByStatusStrict = async (status, signal) => {
+		const { objects, unreadableIds } = parseObjects(await fetchObjects(signal));
+		if (unreadableIds.length > 0) throw new KaiMemoryUnreadableItemsError(unreadableIds);
+		return objects.filter((item) => item.data.status === status);
+	};
+	/**
+	* Envelope ids of every `kai-memory` item this SDK cannot parse, regardless of status — the
+	* admin-facing counterpart to `getItemsByStatusStrict`'s failure. An unreadable item is invisible
+	* to `getItems`/`getItemsByStatus` (dropped and logged) yet blocks every new chat's recall read,
+	* so an admin needs a way to find and clear it; see `deleteUnreadableItem`.
+	*/
+	const getUnreadableItemIds = async (signal) => parseObjects(await fetchObjects(signal)).unreadableIds;
+	/**
+	* Deletes a `kai-memory` object by id without first reading and parsing it — `updateStatus`
+	* can't be reused here because its pending-check read is exactly the parse that fails for an
+	* unreadable item. Intended only for clearing an id surfaced by `getUnreadableItemIds`.
+	*/
+	const deleteUnreadableItem = async (uuid) => {
+		await metastoreClient.repository.deleteMetaObject({
+			objectType: KAI_MEMORY_OBJECT_TYPE,
+			UUID: uuid
+		});
+	};
+	/**
+	* Write a new `pending` note. `chatId` is a required, separate argument rather than a `data`
+	* field — the caller (the memory-handler backend, never the sandboxed agent directly) is what
+	* must supply it, taken from the turn's own ticket context, so a model cannot forge which
+	* session a note came from.
+	*/
+	const createItem = async ({ content, chatId, createdBy }, meta = {}) => {
+		const data = {
+			content,
+			status: "pending",
+			chatId,
+			createdBy
+		};
+		const response = await metastoreClient.repository.createMetaObject({
+			objectType: KAI_MEMORY_OBJECT_TYPE,
+			data,
+			branch: DEFAULT_BRANCH,
+			...meta
+		});
+		return mapObject(response.data);
+	};
+	/**
+	* Approve or reject a pending note (or otherwise move it between statuses).
+	*
+	* - Re-reads and refuses a no-longer-`pending` item (no PATCH precondition mechanism), closing
+	*   the realistic stale-tab race; `useUpdateKnowledgeBaseItemStatus` invalidates on every outcome.
+	* - `rejected` deletes the object outright, so review no longer grows the metastore forever; the
+	*   return value is the pre-delete data with `status` overridden. A later 404 on the
+	*   conflict-check read (only reachable via a prior reject) becomes `KaiMemoryReviewConflictError`.
+	*/
+	const updateStatus = async (uuid, status, meta = {}) => {
+		let current;
+		try {
+			current = await metastoreClient.repository.getMetaObject({
+				objectType: KAI_MEMORY_OBJECT_TYPE,
+				UUID: uuid
+			});
+		} catch (error) {
+			if (require_createFetchClient.isApiError(error) && error.response.status === require_createFetchClient.HttpStatus.NOT_FOUND) throw new KaiMemoryReviewConflictError(uuid, "rejected");
+			throw error;
+		}
+		const parsedCurrent = kaiMemoryItemReadSchema.safeParse(current.data);
+		if (parsedCurrent.success && parsedCurrent.data.data.status !== "pending") throw new KaiMemoryReviewConflictError(uuid, parsedCurrent.data.data.status);
+		if (status === "rejected") {
+			const currentObject = current.data;
+			await metastoreClient.repository.deleteMetaObject({
+				objectType: KAI_MEMORY_OBJECT_TYPE,
+				UUID: uuid
+			});
+			return mapObject({
+				...currentObject,
+				attributes: {
+					...currentObject.attributes,
+					status
+				}
+			});
+		}
+		const response = await metastoreClient.repository.updateMetaObject({
+			objectType: KAI_MEMORY_OBJECT_TYPE,
+			UUID: uuid,
+			data: { status },
+			...meta
+		});
+		return mapObject(response.data);
+	};
+	return {
+		getItems,
+		getItemsByStatus,
+		getItemsByStatusStrict,
+		getUnreadableItemIds,
+		deleteUnreadableItem,
+		createItem,
+		updateStatus
+	};
+};
+//#endregion
+Object.defineProperty(exports, "KAI_MEMORY_OBJECT_TYPE", {
+	enumerable: true,
+	get: function() {
+		return KAI_MEMORY_OBJECT_TYPE;
+	}
+});
+Object.defineProperty(exports, "KAI_MEMORY_STATUSES", {
+	enumerable: true,
+	get: function() {
+		return KAI_MEMORY_STATUSES;
+	}
+});
+Object.defineProperty(exports, "KaiMemoryReviewConflictError", {
+	enumerable: true,
+	get: function() {
+		return KaiMemoryReviewConflictError;
+	}
+});
+Object.defineProperty(exports, "KaiMemoryUnreadableItemsError", {
+	enumerable: true,
+	get: function() {
+		return KaiMemoryUnreadableItemsError;
+	}
+});
+Object.defineProperty(exports, "createKaiMemorySdk", {
+	enumerable: true,
+	get: function() {
+		return createKaiMemorySdk;
+	}
+});
+
+//# sourceMappingURL=kaiMemory-CClSPInt.cjs.map

package/dist/kaiMemory-CClSPInt.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kaiMemory-CClSPInt.cjs","names":["z","formatValidationIssues","isApiError","HttpStatus","parseOrThrow","z"],"sources":["../src/sdks/kaiMemory/vocabulary.ts","../src/sdks/kaiMemory/readSchemas.ts","../src/sdks/kaiMemory/kaiMemorySdk.ts"],"sourcesContent":["/**\n * The closed value set a `kai-memory` object's `status` accepts.\n *\n * A single runtime source for the union in `./types`, mirroring\n * `sdks/semanticLayer/vocabulary.ts`'s pattern — a value cannot exist in the type and be\n * missing from the list a validator or a UI dropdown is built from.\n */\nexport const KAI_MEMORY_STATUSES = ['pending', 'approved', 'rejected'] as const;\n","import { z } from 'zod';\n\nimport type { KaiMemoryData, KaiMemoryMeta } from './types';\nimport { KAI_MEMORY_STATUSES } from './vocabulary';\n\n/**\n * What a read of the metastore is allowed to hand back for a `kai-memory` object — see\n * `sdks/semanticLayer/readSchemas.ts` for the `looseObject` reasoning this mirrors.\n *\n * `status` drops as unrecognized rather than passing through: an item this SDK cannot classify\n * as pending/approved/rejected must never be treated as any of them, in particular `approved`.\n */\nconst kaiMemoryReadSchema: z.ZodType<KaiMemoryData, unknown> = z.looseObject({\n  content: z.string(),\n  status: z.enum(KAI_MEMORY_STATUSES),\n  chatId: z.string(),\n  createdBy: z.string().optional(),\n});\n\nconst kaiMemoryMetaSchema: z.ZodType<KaiMemoryMeta, unknown> = z.looseObject({\n  name: z.string().optional(),\n  branch: z.string().optional(),\n  projectId: z.number().optional(),\n  organizationId: z.string().optional(),\n  revision: z.number().optional(),\n  schemaVersion: z.string().optional(),\n  createdAt: z.string().optional(),\n  lastUpdated: z.string().optional(),\n  revisionCreatedAt: z.string().optional(),\n});\n\n/**\n * The envelope every read comes wrapped in, mapped to the `KaiMemoryItem` the SDK returns. `meta`\n * absent or `null` both normalize to `{}` — see `semanticObjectReadSchema` for why an envelope\n * omitting audit fields is a normalization, not a failure.\n */\nexport const kaiMemoryItemReadSchema = z\n  .object({\n    id: z.string(),\n    attributes: kaiMemoryReadSchema,\n    meta: kaiMemoryMetaSchema.nullish(),\n  })\n  .transform(({ id, attributes, meta }) => ({ uuid: id, data: attributes, meta: meta ?? {} }));\n","import { z } from 'zod';\n\nimport { formatValidationIssues, parseOrThrow } from '../../errors';\nimport { isApiError } from '../../fetchClient';\nimport { HttpStatus } from '../../internal';\n\nimport { kaiMemoryItemReadSchema } from './readSchemas';\nimport type {\n  CreateKaiMemoryMeta,\n  KaiMemoryData,\n  KaiMemoryItem,\n  KaiMemoryStatus,\n  MetastoreClient,\n  UpdateKaiMemoryMeta,\n} from './types';\n\n/** The metastore object type this SDK addresses — see `SEMANTIC_OBJECT_TYPE` for the convention. */\nexport const KAI_MEMORY_OBJECT_TYPE = 'kai-memory';\n\nconst DEFAULT_BRANCH = 'main';\n\n/**\n * The live metastore envelope for a write response — see `RawSemanticObject` in\n * `sdks/semanticLayer/semanticLayerSdk.ts` for why a write asserts this shape rather than parsing\n * it: the metastore is echoing back the object it has just validated and stored.\n */\ntype RawKaiMemoryObject = {\n  type: string;\n  id: string;\n  attributes: KaiMemoryData;\n  meta: KaiMemoryItem['meta'];\n};\n\nconst mapObject = (item: RawKaiMemoryObject): KaiMemoryItem => ({\n  uuid: item.id,\n  data: item.attributes,\n  meta: item.meta,\n});\n\nconst envelopeId = (value: unknown): string | null => {\n  if (typeof value !== 'object' || value === null) return null;\n  const { id } = value as { id?: unknown };\n  return typeof id === 'string' && id !== '' ? id : null;\n};\n\n/**\n * Thrown by `getItemsByStatusStrict` when any `kai-memory` item — of any status, not only the\n * one asked for — could not be parsed. See that function's docstring for why an unreadable item\n * anywhere in the collection fails the whole read rather than being dropped.\n */\nexport class KaiMemoryUnreadableItemsError extends Error {\n  readonly unreadableIds: string[];\n\n  constructor(unreadableIds: string[]) {\n    super(\n      `${unreadableIds.length} kai-memory item(s) could not be read, so the knowledge base ` +\n        `cannot be treated as complete.`,\n    );\n    this.name = 'KaiMemoryUnreadableItemsError';\n    this.unreadableIds = unreadableIds;\n  }\n}\n\n/**\n * Thrown by `updateStatus` when the item is no longer `pending` at write time — see that\n * function's docstring for the race it closes.\n */\nexport class KaiMemoryReviewConflictError extends Error {\n  readonly uuid: string;\n  readonly currentStatus: KaiMemoryStatus;\n\n  constructor(uuid: string, currentStatus: KaiMemoryStatus) {\n    super(\n      `This note was already reviewed (now \"${currentStatus}\") — refusing to overwrite a ` +\n        `decision someone else already made.`,\n    );\n    this.name = 'KaiMemoryReviewConflictError';\n    this.uuid = uuid;\n    this.currentStatus = currentStatus;\n  }\n}\n\ntype ParsedObjects = {\n  objects: KaiMemoryItem[];\n  /** Envelope ids (or `<no id>`) of items that did not match `kaiMemoryItemReadSchema`. */\n  unreadableIds: string[];\n};\n\n/** Shared parse loop behind `getItems` (drops and logs) and `getItemsByStatusStrict` (fails). */\nconst parseObjects = (items: unknown[]): ParsedObjects => {\n  const objects: KaiMemoryItem[] = [];\n  const unreadableIds: string[] = [];\n\n  for (const item of items) {\n    const result = kaiMemoryItemReadSchema.safeParse(item);\n    if (result.success) {\n      objects.push(result.data);\n      continue;\n    }\n\n    const id = envelopeId(item) ?? '<no id>';\n    unreadableIds.push(id);\n    // The object type, the UUID and the failing field, never the content: a memory note's\n    // text is the customer's and does not belong in a console.\n    console.warn(\n      `kaiMemorySdk: kai-memory item \"${id}\" from the metastore response does not match its ` +\n        `declared shape`,\n      formatValidationIssues(result.error.issues),\n    );\n  }\n\n  return { objects, unreadableIds };\n};\n\ntype Options = {\n  metastoreClient: MetastoreClient;\n};\n\nexport const createKaiMemorySdk = ({ metastoreClient }: Options) => {\n  /**\n   * The metastore's list endpoint looks up the `kai-memory` schema before querying, and 404s\n   * (\"Schema not found\") when it was never registered — not an empty result. Since this SDK ships\n   * independently of the backend PR that registers the schema, every read here would otherwise\n   * throw on any stack that hasn't deployed it yet (or hasn't deployed it TO yet, mid-rollout),\n   * indistinguishable from \"this project genuinely has zero kai-memory items\" from the caller's\n   * point of view. Treat the two the same: no schema yet means no items yet.\n   */\n  const fetchObjects = async (signal?: AbortSignal): Promise<unknown[]> => {\n    let response: Awaited<ReturnType<typeof metastoreClient.repository.getMetaObjects>>;\n    try {\n      response = await metastoreClient.repository.getMetaObjects(\n        { objectType: KAI_MEMORY_OBJECT_TYPE },\n        signal,\n      );\n    } catch (error) {\n      if (isApiError(error) && error.response.status === HttpStatus.NOT_FOUND) return [];\n      throw error;\n    }\n    return parseOrThrow(z.array(z.unknown()), response.data);\n  };\n\n  /**\n   * Every `kai-memory` item in the project, parsed rather than asserted.\n   *\n   * - No server-side filter (AI-3975), so a caller after one status still pays for the collection.\n   * - Degrade-on-drop: a malformed item is dropped and logged, for a display consumer (the admin\n   *   review list) that would rather show what it can. A steering-context consumer, where a\n   *   silently missing item is worse than a failed read, must use `getItemsByStatusStrict`.\n   */\n  const getItems = async (signal?: AbortSignal): Promise<KaiMemoryItem[]> => {\n    const { objects } = parseObjects(await fetchObjects(signal));\n    return objects;\n  };\n\n  /** `getItems` narrowed to one status, for the admin review list. */\n  const getItemsByStatus = async (status: KaiMemoryStatus, signal?: AbortSignal) =>\n    (await getItems(signal)).filter((item) => item.data.status === status);\n\n  /**\n   * `getItemsByStatus`, failing closed instead of dropping what it cannot parse.\n   *\n   * For the recall path (folded into every turn's prompt): an unclassifiable item must not be\n   * silently omitted — it might be an `approved` note vanishing with no evidence anything was\n   * missing (\"steering inputs fail the turn\"). Every unreadable item counts, not only ones\n   * matching `status`, since an unparsed item's real status is unknown.\n   */\n  const getItemsByStatusStrict = async (\n    status: KaiMemoryStatus,\n    signal?: AbortSignal,\n  ): Promise<KaiMemoryItem[]> => {\n    const { objects, unreadableIds } = parseObjects(await fetchObjects(signal));\n    if (unreadableIds.length > 0) throw new KaiMemoryUnreadableItemsError(unreadableIds);\n    return objects.filter((item) => item.data.status === status);\n  };\n\n  /**\n   * Envelope ids of every `kai-memory` item this SDK cannot parse, regardless of status — the\n   * admin-facing counterpart to `getItemsByStatusStrict`'s failure. An unreadable item is invisible\n   * to `getItems`/`getItemsByStatus` (dropped and logged) yet blocks every new chat's recall read,\n   * so an admin needs a way to find and clear it; see `deleteUnreadableItem`.\n   */\n  const getUnreadableItemIds = async (signal?: AbortSignal): Promise<string[]> =>\n    parseObjects(await fetchObjects(signal)).unreadableIds;\n\n  /**\n   * Deletes a `kai-memory` object by id without first reading and parsing it — `updateStatus`\n   * can't be reused here because its pending-check read is exactly the parse that fails for an\n   * unreadable item. Intended only for clearing an id surfaced by `getUnreadableItemIds`.\n   */\n  const deleteUnreadableItem = async (uuid: string): Promise<void> => {\n    await metastoreClient.repository.deleteMetaObject({\n      objectType: KAI_MEMORY_OBJECT_TYPE,\n      UUID: uuid,\n    });\n  };\n\n  /**\n   * Write a new `pending` note. `chatId` is a required, separate argument rather than a `data`\n   * field — the caller (the memory-handler backend, never the sandboxed agent directly) is what\n   * must supply it, taken from the turn's own ticket context, so a model cannot forge which\n   * session a note came from.\n   */\n  const createItem = async (\n    { content, chatId, createdBy }: { content: string; chatId: string; createdBy?: string },\n    meta: CreateKaiMemoryMeta = {},\n  ) => {\n    const data: KaiMemoryData = { content, status: 'pending', chatId, createdBy };\n    const response = await metastoreClient.repository.createMetaObject<KaiMemoryData>({\n      objectType: KAI_MEMORY_OBJECT_TYPE,\n      data,\n      branch: DEFAULT_BRANCH,\n      ...meta,\n    });\n\n    return mapObject(response.data as unknown as RawKaiMemoryObject);\n  };\n\n  /**\n   * Approve or reject a pending note (or otherwise move it between statuses).\n   *\n   * - Re-reads and refuses a no-longer-`pending` item (no PATCH precondition mechanism), closing\n   *   the realistic stale-tab race; `useUpdateKnowledgeBaseItemStatus` invalidates on every outcome.\n   * - `rejected` deletes the object outright, so review no longer grows the metastore forever; the\n   *   return value is the pre-delete data with `status` overridden. A later 404 on the\n   *   conflict-check read (only reachable via a prior reject) becomes `KaiMemoryReviewConflictError`.\n   */\n  const updateStatus = async (\n    uuid: string,\n    status: KaiMemoryStatus,\n    meta: UpdateKaiMemoryMeta = {},\n  ) => {\n    let current: Awaited<ReturnType<typeof metastoreClient.repository.getMetaObject>>;\n    try {\n      current = await metastoreClient.repository.getMetaObject<KaiMemoryData>({\n        objectType: KAI_MEMORY_OBJECT_TYPE,\n        UUID: uuid,\n      });\n    } catch (error) {\n      if (isApiError(error) && error.response.status === HttpStatus.NOT_FOUND) {\n        throw new KaiMemoryReviewConflictError(uuid, 'rejected');\n      }\n      throw error;\n    }\n\n    const parsedCurrent = kaiMemoryItemReadSchema.safeParse(current.data);\n    if (parsedCurrent.success && parsedCurrent.data.data.status !== 'pending') {\n      throw new KaiMemoryReviewConflictError(uuid, parsedCurrent.data.data.status);\n    }\n\n    if (status === 'rejected') {\n      const currentObject = current.data as unknown as RawKaiMemoryObject;\n      await metastoreClient.repository.deleteMetaObject({\n        objectType: KAI_MEMORY_OBJECT_TYPE,\n        UUID: uuid,\n      });\n\n      return mapObject({\n        ...currentObject,\n        attributes: { ...currentObject.attributes, status },\n      });\n    }\n\n    const response = await metastoreClient.repository.updateMetaObject<KaiMemoryData>({\n      objectType: KAI_MEMORY_OBJECT_TYPE,\n      UUID: uuid,\n      data: { status },\n      ...meta,\n    });\n\n    return mapObject(response.data as unknown as RawKaiMemoryObject);\n  };\n\n  return {\n    getItems,\n    getItemsByStatus,\n    getItemsByStatusStrict,\n    getUnreadableItemIds,\n    deleteUnreadableItem,\n    createItem,\n    updateStatus,\n  };\n};\n"],"mappings":"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"}