@tangle-network/chatgpt-agents-kit 0.1.2 → 0.1.3

package/dist/src/contracts.d.ts

@@ -112,6 +112,11 @@ export interface NativeTaskSummary extends Target {
     updatedAt?: string;
     completedAt?: string;
 }
+export interface NativeTaskOptions {
+    contextVersion?: string;
+    /** One task only. Native policy validates access, availability and input-bound replay. */
+    model?: string;
+}
 export interface NativeServices {
     list(): Promise<Array<{
         workspaceId: string;
@@ -136,9 +141,7 @@ export interface NativeServices {
     putFile?(target: Target, path: string, content: string, expectedRevision: string | null): Promise<{
         revision: string;
     }>;
-    startTask?(target: Target, turnId: string, brief: string, options?: {
-        contextVersion?: string;
-    }): Promise<NativeTask>;
+    startTask?(target: Target, turnId: string, brief: string, options?: NativeTaskOptions): Promise<NativeTask>;
     getTask?(target: Target, turnId: string): Promise<NativeTask>;
     readResponse?(target: Target, turnId: string): Promise<NativeResponse | null>;
     /** Cancel exactly this execution; never choose the latest run in a session. */
@@ -169,6 +172,8 @@ export interface NativeBinding {
     requiredScopes: Partial<Record<Action, readonly string[]>>;
     /** Calls existing workspace/thread RBAC. Recheck live, including after awaited reads. */
     authorize(target: Target, action: Action): Promise<void>;
+    /** Opt in only when startTask validates and binds an explicit model to task identity. */
+    modelSelection?: boolean;
     services: NativeServices;
 }
 export interface NativeTool {

package/dist/src/gtm.d.ts

@@ -12,6 +12,7 @@ export interface GtmNativeContext {
     request(path: string, init: RequestInit): Promise<Response>;
     /** Use the persisted agent-app turn path. HTTP 200 alone is NOT admission. */
     turns?: Pick<NativeServices, 'startTask' | 'getTask'>;
+    modelSelection?: NativeBinding['modelSelection'];
     interactions?: Pick<NativeServices, 'pendingDecisions' | 'decide'>;
     /** Native paginated discovery; absent services expose no discovery tools. */
     directory?: Pick<NativeServices, 'listThreads' | 'listTasks'>;

package/dist/src/gtm.js

@@ -76,7 +76,7 @@ export function createGtmBinding(context) {
     };
     return {
         platformUserId: context.platformUserId, applicationUserId: context.applicationUserId,
-        appName: 'tangle-agents-gtm', authorize: context.authorize, services,
+        appName: 'tangle-agents-gtm', authorize: context.authorize, services, modelSelection: context.modelSelection,
         // These are GTM's reviewed native scopes. Do NOT reinterpret Hub's `read`
         // or `workflows:write` token as these permissions; ungranted actions cannot run.
         requiredScopes: { list: read, connect: read, create: write, handoff: write, delegate: run, task: read, output: read, decisions: read, decide: run },

package/dist/src/index.d.ts

@@ -1,7 +1,7 @@
 export { createAgentsHandler } from './kit.ts';
 export { createGtmBinding } from './gtm.ts';
 export { AgentFailure } from './contracts.ts';
-export type { Action, Metadata, NativeBinding, NativeChannel, NativeFile, NativeMcpFactory, NativeServices, NativeTask, NativeResponse, NativeConnection, NativeEnvironment, OAuthResource, Principal, Target, NativeDirectoryQuery, NativeTaskQuery, NativeThreadSummary, NativeTaskSummary, } from './contracts.ts';
+export type { Action, Metadata, NativeBinding, NativeChannel, NativeFile, NativeMcpFactory, NativeServices, NativeTask, NativeTaskOptions, NativeResponse, NativeConnection, NativeEnvironment, OAuthResource, Principal, Target, NativeDirectoryQuery, NativeTaskQuery, NativeThreadSummary, NativeTaskSummary, } from './contracts.ts';
 export type { GtmNativeContext } from './gtm.ts';
 export type { InspectionBinding, InspectionExposure } from './inspection.ts';
 export { createTaskEvents, TASK_EVENT } from './task-events.ts';

package/dist/src/kit.js

@@ -225,7 +225,10 @@ async function run(action, args, binding, revalidate, signal, policy, canReadTas
                 throw new PreAdmissionFailure(error);
             }
             try {
-                const task = await s.startTask(target, args.turnId, args.prompt, args.contextVersion === undefined ? undefined : { contextVersion: args.contextVersion });
+                const task = await s.startTask(target, args.turnId, args.prompt, args.contextVersion === undefined && args.model === undefined ? undefined : {
+                    ...(args.contextVersion === undefined ? {} : { contextVersion: args.contextVersion }),
+                    ...(args.model === undefined ? {} : { model: args.model }),
+                });
                 result = await taskReceipt(binding, target, await observe(task, policy.defaultMs), args.turnId, canReadOutput, checkOutput);
                 break;
             }
@@ -467,6 +470,9 @@ export function createAgentsHandler(options) {
                                 _meta: { ui: { prefersBorder: true, csp: { connectDomains: [], resourceDomains: [] }, ...(options.cards.domain ? { domain: options.cards.domain } : {}) } },
                             }], ...(v2 ? { resultType: 'complete' } : {}) } });
             }
+            const actionSchemas = { ...schemas, delegate: binding.modelSelection
+                    ? { ...schemas.delegate, model: { ...str, optional: true, description: 'Model for this task only. The app validates availability and permissions; omission preserves its saved default. Changing model requires a new turnId.' } }
+                    : schemas.delegate };
             const directory = directoryTools(binding, actions, revalidate);
             const executableTools = [...actions.map(action => names[action]), ...directory.map(tool => tool.name)];
             const workflows = describeAgentWorkflows(actions);
@@ -475,9 +481,9 @@ export function createAgentsHandler(options) {
             const tools = [
                 { name: 'agent_profile', description: 'Stable application identity of the authenticated account.', inputSchema: { type: 'object', properties: {}, additionalProperties: false }, run: async (args) => { validate(args, {}); return { id: binding.applicationUserId, ...(binding.name ? { name: binding.name } : {}) }; } },
                 { name: 'agent_capabilities', description: 'Discover actions actually supported for this identity, app and grant now.', inputSchema: { type: 'object', properties: {}, additionalProperties: false }, run: async (args) => { validate(args, {}); return { appName: binding.appName, actions: [...executableTools, ...(handoff ? [handoff.name] : [])], workflows, inspection: inspection?.tools.map(tool => tool.name) ?? [], media: ['text/plain; charset=utf-8'], compatibilityAliases: actions.includes('delegate') ? { delegate_task: names.delegate } : {}, preferredPromptTool: actions.includes('delegate') ? names.delegate : null, resultKinds: canReadOutput ? [...(binding.services.readFile ? ['files'] : []), ...(binding.services.readResponse ? ['response'] : [])] : [], execution: 'native-application', stateStore: 'native-application', taskWait: { defaultMs: waitPolicy.defaultMs, maxMs: waitPolicy.maxMs }, events: eventsEnabled ? { name: 'agent.task_updated', protocolVersion: '2026-07-28', delivery: ['webhook'], replay: false } : null }; } },
-                ...advertisedActions.map(action => ({ name: names[action], description: descriptions[action], inputSchema: { type: 'object', properties: Object.fromEntries(Object.entries(schemas[action]).map(([key, value]) => { const { optional: _optional, ...schema } = value; return [key, schema]; })), required: Object.keys(schemas[action]).filter(key => !schemas[action][key].optional), additionalProperties: false }, run: async (args) => {
+                ...advertisedActions.map(action => ({ name: names[action], description: descriptions[action], inputSchema: { type: 'object', properties: Object.fromEntries(Object.entries(actionSchemas[action]).map(([key, value]) => { const { optional: _optional, ...schema } = value; return [key, schema]; })), required: Object.keys(actionSchemas[action]).filter(key => !actionSchemas[action][key].optional), additionalProperties: false }, run: async (args) => {
                         try {
-                            validate(args, schemas[action]);
+                            validate(args, actionSchemas[action]);
                         }
                         catch (error) {
                             throw action === 'delegate' ? new PreAdmissionFailure(error) : error;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/chatgpt-agents-kit",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/tangle-network/chatgpt-plugins.git",