@osdk/aip-core 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# @osdk/aip-core
+
+## 0.2.0
+
+### Minor Changes
+
+- 86cc68c: Add AI SDK custom provider under `@osdk/aip-core/ai-sdk` implementing LanguageModelV3 with `doGenerate` and `doStream`, enabling usage with the `ai` package's `generateText` and `streamText` functions.
+- f747fa3: Add `@osdk/aip-core` — the AIP SDK's chat completion primitives, backed by the Foundry Language Model Service's OpenAI-compatible proxy. Construct a model via `foundryModel({ client, model })` and call `generateText` for non-streaming completions or `streamText` for streaming. `LmsChatTransport` plugs into UI hooks; `useChat` is exposed from `@osdk/react/experimental/aip` and returns `messages`, `status`, `sendMessage`, `regenerate`, `stop`, `clearError`, and accepts a `transport` override. v0 is text-only and single-step — tool round-trips, multi-step loops, image/file content, Zod tool schemas, and stream resume are deferred.
+
+### Patch Changes
+
+- Updated dependencies [d9c891e]
+- Updated dependencies [f12977d]
+- Updated dependencies [eb36e21]
+- Updated dependencies [d892397]
+- Updated dependencies [c5a6047]
+- Updated dependencies [45be476]
+- Updated dependencies [20e9678]
+  - @osdk/language-models@0.5.0
+  - @osdk/client@2.14.0

package/README.md

@@ -0,0 +1,211 @@
+# @osdk/aip-core
+
+Core building blocks for AIP applications backed by the Foundry Language Model Service (LMS). Provides streaming chat completions, tool calling, and an AI SDK adapter.
+
+## Installation
+
+```sh
+pnpm add @osdk/aip-core
+```
+
+Peer dependencies:
+
+```sh
+pnpm add @osdk/client @osdk/language-models
+```
+
+## Native API
+
+### `foundryModel`
+
+Creates a language model handle for Foundry LMS.
+
+```ts
+import { foundryModel } from "@osdk/aip-core";
+
+const model = foundryModel({
+  client, // PlatformClient from @osdk/client
+  model: "gpt-4o", // LMS model API name or a ModelIdentifier
+});
+```
+
+The `model` parameter accepts either a string (LMS API name like `"gpt-4o"`) or a structured identifier:
+
+```ts
+// Built-in LMS model
+{ type: "lmsModel", apiName: "gpt-4o" }
+
+// Customer-registered model
+{ type: "registeredModel", registeredModelRid: "ri.language-model-service..." }
+```
+
+### `generateText`
+
+Performs a single chat completion and returns the full result.
+
+```ts
+import { foundryModel, generateText } from "@osdk/aip-core";
+
+const model = foundryModel({ client, model: "gpt-4o" });
+
+const result = await generateText({
+  model,
+  prompt: "Summarize the key points of this document.",
+});
+
+console.log(result.text);
+console.log(result.usage); // { inputTokens, outputTokens, totalTokens, ... }
+```
+
+#### With system instructions
+
+```ts
+const result = await generateText({
+  model,
+  system: "You are a helpful assistant that responds concisely.",
+  messages: [
+    { role: "user", content: "What is TypeScript?" },
+  ],
+});
+```
+
+#### With tool calling
+
+```ts
+const result = await generateText({
+  model,
+  prompt: "What's the weather in London?",
+  tools: {
+    getWeather: {
+      description: "Get the current weather for a location",
+      inputSchema: {
+        type: "object",
+        properties: {
+          location: { type: "string" },
+        },
+        required: ["location"],
+      },
+    },
+  },
+  toolChoice: "auto",
+});
+
+for (const call of result.toolCalls) {
+  console.log(call.toolName, call.input);
+}
+```
+
+#### Callbacks
+
+```ts
+const result = await generateText({
+  model,
+  prompt: "Hello",
+  onStepFinish: (step) => {
+    console.log("Step finished:", step.finishReason);
+  },
+  onFinish: (event) => {
+    console.log("Total usage:", event.totalUsage);
+  },
+});
+```
+
+#### Sampling parameters
+
+| Parameter          | Description                      |
+| ------------------ | -------------------------------- |
+| `maxOutputTokens`  | Maximum tokens to generate       |
+| `temperature`      | Randomness (0 = deterministic)   |
+| `topP`             | Nucleus sampling threshold       |
+| `presencePenalty`  | Penalize repeated topics         |
+| `frequencyPenalty` | Penalize repeated tokens         |
+| `stopSequences`    | Stop generation at these strings |
+| `seed`             | Deterministic sampling seed      |
+
+## AI SDK Provider
+
+`@osdk/aip-core` ships a custom provider for the [AI SDK](https://ai-sdk.dev), allowing you to use Foundry LMS models with `generateText`, `streamText`, and other AI SDK functions.
+
+### Additional dependencies
+
+```sh
+pnpm add ai @ai-sdk/provider
+```
+
+### Usage
+
+```ts
+import { createFoundryAI } from "@osdk/aip-core/ai-sdk";
+import { generateText } from "ai";
+
+const foundryAI = createFoundryAI({ client });
+
+const { text } = await generateText({
+  model: foundryAI("gpt-4o"),
+  prompt: "Hello, world",
+});
+```
+
+### Streaming
+
+```ts
+import { createFoundryAI } from "@osdk/aip-core/ai-sdk";
+import { streamText } from "ai";
+
+const foundryAI = createFoundryAI({ client });
+
+const result = streamText({
+  model: foundryAI("gpt-4o"),
+  prompt: "Write a poem about TypeScript.",
+});
+
+for await (const chunk of result.textStream) {
+  process.stdout.write(chunk);
+}
+```
+
+### Registered models
+
+```ts
+const model = foundryAI({
+  type: "registeredModel",
+  registeredModelRid: "ri.language-model-service...",
+});
+```
+
+### Tool calling with AI SDK
+
+```ts
+import { createFoundryAI } from "@osdk/aip-core/ai-sdk";
+import { generateText, tool } from "ai";
+import { z } from "zod";
+
+const foundryAI = createFoundryAI({ client });
+
+const result = await generateText({
+  model: foundryAI("gpt-4o"),
+  prompt: "What's the weather in London?",
+  tools: {
+    getWeather: tool({
+      description: "Get the current weather for a location",
+      parameters: z.object({ location: z.string() }),
+      execute: async ({ location }) => {
+        return { temperature: 18, condition: "cloudy" };
+      },
+    }),
+  },
+});
+```
+
+## v0 Limitations
+
+The current release (v0) has the following limitations. Unsupported options surface as warnings in the result rather than throwing errors.
+
+- **Single-step only** — multi-step tool loops (`stopWhen`, `prepareStep`) are not yet supported
+- **Text content only** — image and file parts in messages are ignored with a warning
+- **No structured output** — JSON response format is not yet wired
+- **No `topK`** — the Foundry LMS OpenAI proxy does not accept this parameter
+
+## License
+
+Apache-2.0

package/ai-sdk.d.ts

@@ -0,0 +1,17 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export * from "./build/cjs/public/ai-sdk.cjs";

package/build/browser/ai-sdk/convert-prompt.js

@@ -0,0 +1,136 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export function convertPrompt(prompt, warnings) {
+  const messages = [];
+  for (const message of prompt) {
+    messages.push(...convertMessage(message, warnings));
+  }
+  return messages;
+}
+function convertMessage(message, warnings) {
+  switch (message.role) {
+    case "system":
+      return [{
+        role: "system",
+        content: message.content
+      }];
+    case "user":
+      {
+        const parts = [];
+        for (const part of message.content) {
+          switch (part.type) {
+            case "text":
+              parts.push({
+                type: "text",
+                text: part.text
+              });
+              break;
+            case "file":
+              warnings.push({
+                type: "unsupported",
+                feature: "user file content",
+                details: "File content in user messages is not supported in v0 — ignored"
+              });
+              break;
+          }
+        }
+        if (parts.length === 0) {
+          parts.push({
+            type: "text",
+            text: ""
+          });
+        }
+        return [{
+          role: "user",
+          content: parts
+        }];
+      }
+    case "assistant":
+      {
+        let text = "";
+        const toolCalls = [];
+        for (const part of message.content) {
+          switch (part.type) {
+            case "text":
+              text += part.text;
+              break;
+            case "tool-call":
+              toolCalls.push({
+                id: part.toolCallId,
+                type: "function",
+                function: {
+                  name: part.toolName,
+                  arguments: typeof part.input === "string" ? part.input : JSON.stringify(part.input ?? {})
+                }
+              });
+              break;
+            case "reasoning":
+            case "file":
+            case "tool-result":
+              warnings.push({
+                type: "unsupported",
+                feature: `assistant ${part.type} content`,
+                details: `"${part.type}" parts in assistant messages are not supported in v0 — ignored`
+              });
+              break;
+          }
+        }
+        return [{
+          role: "assistant",
+          content: text.length > 0 ? text : null,
+          tool_calls: toolCalls.length > 0 ? toolCalls : undefined
+        }];
+      }
+    case "tool":
+      return message.content.filter(part => {
+        if (part.type === "tool-result") return true;
+        warnings.push({
+          type: "unsupported",
+          feature: `tool ${part.type} content`,
+          details: `"${part.type}" parts in tool messages are not supported in v0 — ignored`
+        });
+        return false;
+      }).map(part => ({
+        role: "tool",
+        content: stringifyToolResult(part.output, warnings),
+        tool_call_id: part.toolCallId
+      }));
+  }
+}
+function stringifyToolResult(output, warnings) {
+  switch (output.type) {
+    case "text":
+    case "error-text":
+      return output.value;
+    case "json":
+    case "error-json":
+      return JSON.stringify(output.value);
+    case "execution-denied":
+      return output.reason ?? "Tool execution denied";
+    case "content":
+      return output.value.map(c => {
+        if (c.type === "text") return c.text;
+        warnings.push({
+          type: "unsupported",
+          feature: "tool result media content",
+          details: "Non-text tool result content is not supported in v0 — ignored"
+        });
+        return "";
+      }).filter(s => s.length > 0).join("\n");
+  }
+}
+//# sourceMappingURL=convert-prompt.js.map

package/build/browser/ai-sdk/convert-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-prompt.js","names":["convertPrompt","prompt","warnings","messages","message","push","convertMessage","role","content","parts","part","type","text","feature","details","length","toolCalls","id","toolCallId","function","name","toolName","arguments","input","JSON","stringify","tool_calls","undefined","filter","map","stringifyToolResult","output","tool_call_id","value","reason","c","s","join"],"sources":["convert-prompt.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  LanguageModelV3Message,\n  LanguageModelV3Prompt,\n  LanguageModelV3ToolResultOutput,\n  SharedV3Warning,\n} from \"@ai-sdk/provider\";\n\nexport interface OpenAiMessage {\n  role: \"system\" | \"user\" | \"assistant\" | \"tool\";\n  content: string | Array<{ type: \"text\"; text: string }> | null;\n  tool_calls?: Array<OpenAiAssistantToolCall>;\n  tool_call_id?: string;\n}\n\nexport interface OpenAiAssistantToolCall {\n  id: string;\n  type: \"function\";\n  function: { name: string; arguments: string };\n}\n\nexport function convertPrompt(\n  prompt: LanguageModelV3Prompt,\n  warnings: Array<SharedV3Warning>,\n): Array<OpenAiMessage> {\n  const messages: Array<OpenAiMessage> = [];\n\n  for (const message of prompt) {\n    messages.push(...convertMessage(message, warnings));\n  }\n\n  return messages;\n}\n\nfunction convertMessage(\n  message: LanguageModelV3Message,\n  warnings: Array<SharedV3Warning>,\n): Array<OpenAiMessage> {\n  switch (message.role) {\n    case \"system\":\n      return [{ role: \"system\", content: message.content }];\n\n    case \"user\": {\n      const parts: Array<{ type: \"text\"; text: string }> = [];\n      for (const part of message.content) {\n        switch (part.type) {\n          case \"text\":\n            parts.push({ type: \"text\", text: part.text });\n            break;\n          case \"file\":\n            warnings.push({\n              type: \"unsupported\",\n              feature: \"user file content\",\n              details:\n                \"File content in user messages is not supported in v0 — ignored\",\n            });\n            break;\n        }\n      }\n      if (parts.length === 0) {\n        parts.push({ type: \"text\", text: \"\" });\n      }\n      return [{ role: \"user\", content: parts }];\n    }\n\n    case \"assistant\": {\n      let text = \"\";\n      const toolCalls: Array<OpenAiAssistantToolCall> = [];\n      for (const part of message.content) {\n        switch (part.type) {\n          case \"text\":\n            text += part.text;\n            break;\n          case \"tool-call\":\n            toolCalls.push({\n              id: part.toolCallId,\n              type: \"function\",\n              function: {\n                name: part.toolName,\n                arguments: typeof part.input === \"string\"\n                  ? part.input\n                  : JSON.stringify(part.input ?? {}),\n              },\n            });\n            break;\n          case \"reasoning\":\n          case \"file\":\n          case \"tool-result\":\n            warnings.push({\n              type: \"unsupported\",\n              feature: `assistant ${part.type} content`,\n              details:\n                `\"${part.type}\" parts in assistant messages are not supported in v0 — ignored`,\n            });\n            break;\n        }\n      }\n      return [{\n        role: \"assistant\",\n        content: text.length > 0 ? text : null,\n        tool_calls: toolCalls.length > 0 ? toolCalls : undefined,\n      }];\n    }\n\n    case \"tool\":\n      return message.content\n        .filter(\n          (part): part is Extract<typeof part, { type: \"tool-result\" }> => {\n            if (part.type === \"tool-result\") return true;\n            warnings.push({\n              type: \"unsupported\",\n              feature: `tool ${part.type} content`,\n              details:\n                `\"${part.type}\" parts in tool messages are not supported in v0 — ignored`,\n            });\n            return false;\n          },\n        )\n        .map((part) => ({\n          role: \"tool\" as const,\n          content: stringifyToolResult(part.output, warnings),\n          tool_call_id: part.toolCallId,\n        }));\n  }\n}\n\nfunction stringifyToolResult(\n  output: LanguageModelV3ToolResultOutput,\n  warnings: Array<SharedV3Warning>,\n): string {\n  switch (output.type) {\n    case \"text\":\n    case \"error-text\":\n      return output.value;\n    case \"json\":\n    case \"error-json\":\n      return JSON.stringify(output.value);\n    case \"execution-denied\":\n      return output.reason ?? \"Tool execution denied\";\n    case \"content\":\n      return output.value\n        .map((c) => {\n          if (c.type === \"text\") return c.text;\n          warnings.push({\n            type: \"unsupported\",\n            feature: \"tool result media content\",\n            details:\n              \"Non-text tool result content is not supported in v0 — ignored\",\n          });\n          return \"\";\n        })\n        .filter((s) => s.length > 0)\n        .join(\"\\n\");\n  }\n}\n"],"mappings":"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","ignoreList":[]}