lingxios 1.0.0

package/dist/src/integrations/lingxiloop/learning.js

@@ -0,0 +1,150 @@
+import { nativeWork } from './actions.js';
+export const LEARNING_METHODS = { list_attempts: ['activityId', 'missionStepId'], get_attempt: ['attemptId'], propose_evaluation: ['attemptId', 'demonstratedLevel', 'confidence', 'rubricResults', 'feedback', 'sourceEvidenceId', 'verifierEvidenceId'], record_attempt: ['activityId', 'missionStepId', 'evidenceClientMsgNos', 'documentIds', 'canvasFrameIds', 'assistance'], draft_knowledge_units: ['knowledgeUnits'], draft_activity: ['title', 'instructions', 'kind', 'evaluationMode', 'targetLevel', 'rubric', 'knowledgeUnitIds', 'dueAt'], start_mission: ['goal', 'successCriteria', 'missionKind', 'sourceClientMsgNo', 'explicit'], update_step: ['missionId', 'stepId', 'status', 'outcome', 'sourceEvidenceId', 'attemptId'], add_steps: ['missionId', 'steps'], finish_planning: ['missionId'], complete_mission: ['missionId'], current: [], get_learner_state: [], list_knowledge_units: [], list_due: [], get_mission: ['missionId'], get_activity: ['activityId'] };
+function draftText(value) {
+    if (typeof value !== 'string' || !value.trim() || value.length > 10000)
+        throw new Error('draft text must contain 1 to 10000 characters');
+    return value.trim();
+}
+function draftLevel(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isInteger(value) || Number(value) < 1 || Number(value) > 4)
+        throw new Error('targetLevel must be 1-4');
+    return Number(value);
+}
+function draftIds(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value) || value.length > 100)
+        throw new Error('draft ID lists are limited to 100 items');
+    const ids = value.map(draftText);
+    if (new Set(ids).size !== ids.length)
+        throw new Error('draft IDs must be unique');
+    return ids;
+}
+export async function executeLearning(work, action, services) {
+    const api = services.learning;
+    const method = action.action.slice('learning.'.length);
+    if (!api || !action.action.startsWith('learning.') || !Object.hasOwn(LEARNING_METHODS, method))
+        throw new Error('unsupported learning action');
+    const allowed = LEARNING_METHODS[method];
+    if (Object.keys(action.args).some(key => !allowed.includes(key)))
+        throw new Error('unknown learning argument');
+    const native = nativeWork(work);
+    await services.permissionService.assertCan({ actorUserId: native.authorizationUserId, companyId: native.companyId, action: method === 'draft_knowledge_units' || method === 'draft_activity' || method === 'update_step' || method === 'add_steps' || method === 'finish_planning' || method === 'complete_mission' ? 'learning:submit' : 'learning:read', resource: { type: 'conversation', id: native.channelId } });
+    const context = await api.loadLearningTurnContext(native, native.authorizationUserId);
+    if (!context)
+        throw new Error('conversation is not bound to a learning project');
+    switch (method) {
+        case 'draft_knowledge_units':
+        case 'draft_activity': {
+            await services.permissionService.assertCan({ actorUserId: native.authorizationUserId, companyId: native.companyId,
+                action: 'learning:submit', resource: { type: 'project', id: context.project.id } });
+            const scope = { companyId: work.tenantId, projectId: context.project.id, actorId: work.agentId, actorKind: 'agent' };
+            if (method === 'draft_knowledge_units') {
+                const units = action.args['knowledgeUnits'];
+                if (!Array.isArray(units) || !units.length || units.length > 100)
+                    throw new Error('knowledgeUnits must contain 1 to 100 items');
+                const knowledgeUnits = units.map(value => {
+                    if (!value || typeof value !== 'object' || Array.isArray(value))
+                        throw new Error('invalid knowledge unit');
+                    const item = value;
+                    if (Object.keys(item).some(key => !['title', 'successCriteria', 'targetLevel', 'prerequisiteKnowledgeUnitIds'].includes(key)))
+                        throw new Error('unknown knowledge unit field');
+                    const targetLevel = draftLevel(item['targetLevel']), prerequisiteKnowledgeUnitIds = draftIds(item['prerequisiteKnowledgeUnitIds']);
+                    return { title: draftText(item['title']), successCriteria: draftText(item['successCriteria']),
+                        ...(targetLevel === undefined ? {} : { targetLevel }), ...(prerequisiteKnowledgeUnitIds === undefined ? {} : { prerequisiteKnowledgeUnitIds }) };
+                });
+                return api.createKnowledgeUnits({ ...scope, knowledgeUnits });
+            }
+            const { kind, evaluationMode, rubric, dueAt } = action.args;
+            if (kind !== 'LESSON' && kind !== 'PRACTICE' && kind !== 'ASSESSMENT' && kind !== 'PROJECT' && kind !== 'REVIEW')
+                throw new Error('invalid activity kind');
+            if (evaluationMode !== undefined && evaluationMode !== 'AGENT_FORMATIVE' && evaluationMode !== 'TEACHER_REQUIRED')
+                throw new Error('invalid evaluationMode');
+            if (rubric !== undefined && (!Array.isArray(rubric) || rubric.length > 100))
+                throw new Error('rubric is limited to 100 items');
+            if (dueAt !== undefined && (typeof dueAt !== 'string' || dueAt.length > 100 || !Number.isFinite(Date.parse(dueAt))))
+                throw new Error('invalid dueAt');
+            const targetLevel = draftLevel(action.args['targetLevel']), knowledgeUnitIds = draftIds(action.args['knowledgeUnitIds']);
+            return api.draftActivity({ ...scope, title: draftText(action.args['title']), instructions: draftText(action.args['instructions']), kind,
+                ...(evaluationMode === undefined ? {} : { evaluationMode }), ...(targetLevel === undefined ? {} : { targetLevel }),
+                ...(rubric === undefined ? {} : { rubric }), ...(knowledgeUnitIds === undefined ? {} : { knowledgeUnitIds }), ...(dueAt === undefined ? {} : { dueAt }) });
+        }
+        case 'current':
+        case 'get_learner_state': return context;
+        case 'list_knowledge_units': return context.knowledgeUnits;
+        case 'list_due': return context.due;
+        case 'get_mission': {
+            const id = action.args['missionId'];
+            if (id === undefined)
+                return context.activeMission ?? null;
+            if (typeof id !== 'string' || !id.trim())
+                throw new Error('missionId must be non-empty');
+            if (!context.learnerId)
+                throw new Error('current learning room has no learner scope');
+            return api.getMission(id, work.tenantId, context.project.id, context.learnerId, work.sessionId);
+        }
+        case 'update_step':
+        case 'add_steps':
+        case 'finish_planning':
+        case 'complete_mission': {
+            const id = action.args['missionId'];
+            if (typeof id !== 'string' || !id.trim())
+                throw new Error('missionId must be non-empty');
+            if (!context.learnerId)
+                throw new Error('current learning room has no learner scope');
+            await api.getMission(id, work.tenantId, context.project.id, context.learnerId, work.sessionId);
+            if (method === 'update_step') {
+                const stepId = action.args['stepId'], status = action.args['status'];
+                if (typeof stepId !== 'string' || !stepId.trim())
+                    throw new Error('stepId must be non-empty');
+                if (status !== 'OPEN' && status !== 'IN_PROGRESS' && status !== 'COMPLETED' && status !== 'CANCELLED')
+                    throw new Error('invalid step status');
+                const input = { missionId: id, stepId, status };
+                for (const key of ['outcome', 'sourceEvidenceId', 'attemptId']) {
+                    const value = action.args[key];
+                    if (value === undefined)
+                        continue;
+                    if (typeof value !== 'string' || !value.trim() || value.length > 10_000)
+                        throw new Error(`${key} must contain 1 to 10000 characters`);
+                    input[key] = value;
+                }
+                return api.updateMissionStep(native, input);
+            }
+            if (method === 'add_steps') {
+                const input = action.args['steps'];
+                if (!Array.isArray(input) || input.length < 1 || input.length > 64)
+                    throw new Error('steps must contain between 1 and 64 items');
+                const steps = input.map(value => {
+                    if (!value || typeof value !== 'object' || Array.isArray(value))
+                        throw new Error('step must be an object');
+                    const step = value;
+                    if (Object.keys(step).some(key => !['kind', 'description', 'successCriteria', 'knowledgeUnitId'].includes(key)))
+                        throw new Error('unknown step argument');
+                    const kind = step['kind'];
+                    if (kind !== 'LEARN' && kind !== 'PRACTICE' && kind !== 'CHECK' && kind !== 'REFLECT')
+                        throw new Error('invalid step kind');
+                    const description = step['description'], successCriteria = step['successCriteria'], knowledgeUnitId = step['knowledgeUnitId'];
+                    for (const value of [description, successCriteria]) {
+                        if (typeof value !== 'string' || !value.trim() || value.length > 10_000)
+                            throw new Error('step description and successCriteria must contain 1 to 10000 characters');
+                    }
+                    if (knowledgeUnitId !== undefined && (typeof knowledgeUnitId !== 'string' || !knowledgeUnitId.trim()))
+                        throw new Error('knowledgeUnitId must be non-empty');
+                    return { kind, description: description, successCriteria: successCriteria, ...(typeof knowledgeUnitId === 'string' ? { knowledgeUnitId } : {}) };
+                });
+                return api.addMissionSteps(native, id, steps);
+            }
+            return method === 'finish_planning' ? api.finishMissionPlanning(native, id) : api.completeMission(native, id);
+        }
+        case 'get_activity': {
+            const id = action.args['activityId'];
+            if (typeof id !== 'string' || !id.trim())
+                throw new Error('activityId must be non-empty');
+            return api.getActivity(id, work.tenantId, context.project.id);
+        }
+        default: throw new Error('unsupported learning action');
+    }
+}
+//# sourceMappingURL=learning.js.map

package/dist/src/integrations/lingxiloop/learning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.js","sourceRoot":"","sources":["../../../../src/integrations/lingxiloop/learning.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/lingxiloop/memory.d.ts

@@ -0,0 +1,14 @@
+import { type HostAction, type WorkItem } from '../../protocol/types.js';
+import { type SqlPool } from '../../control-plane/pg-store.js';
+import type { LingxiLoopServices } from './service-contracts.js';
+import type { SemanticMemory } from '../../memory/semantic.js';
+export declare const MEMORY_METHODS: {
+    readonly list: readonly ["scope", "learnerId", "limit"];
+    readonly recall: readonly ["scope", "learnerId", "query", "limit"];
+    readonly note: readonly ["scope", "learnerId", "body", "kind", "validUntil"];
+    readonly verify: readonly ["scope", "learnerId", "id", "expectedVersion", "validUntil"];
+    readonly pin: readonly ["scope", "learnerId", "id", "expectedVersion", "pinned"];
+    readonly delete: readonly ["scope", "learnerId", "id", "expectedVersion"];
+};
+export declare function recallMemoryContext(work: Omit<WorkItem, 'leaseToken'>, services: Pick<LingxiLoopServices, 'permissionService'>, database: SqlPool, semantic?: SemanticMemory): Promise<import("../../memory/store.js").MemorySnapshot>;
+export declare function executeMemory(work: Omit<WorkItem, 'leaseToken'>, action: HostAction, services: Pick<LingxiLoopServices, 'permissionService'>, database: SqlPool, semantic?: SemanticMemory): Promise<Record<string, unknown> | Record<string, unknown>[] | undefined>;

package/dist/src/integrations/lingxiloop/memory.js

@@ -0,0 +1,133 @@
+import { createHash } from 'node:crypto';
+import { recallMemories, snapshotMemories } from '../../memory/store.js';
+import { sessionKeyOf } from '../../protocol/types.js';
+import { withTransaction } from '../../control-plane/pg-store.js';
+export const MEMORY_METHODS = {
+    list: ['scope', 'learnerId', 'limit'], recall: ['scope', 'learnerId', 'query', 'limit'],
+    note: ['scope', 'learnerId', 'body', 'kind', 'validUntil'],
+    verify: ['scope', 'learnerId', 'id', 'expectedVersion', 'validUntil'],
+    pin: ['scope', 'learnerId', 'id', 'expectedVersion', 'pinned'],
+    delete: ['scope', 'learnerId', 'id', 'expectedVersion'],
+};
+export async function recallMemoryContext(work, services, database, semantic) {
+    if (!work.principalId)
+        throw new Error('missing memory recall principal');
+    await services.permissionService.assertCan({ actorUserId: work.principalId, companyId: work.tenantId,
+        action: 'agent_memory:read', resource: { type: 'conversation', id: work.sessionId } });
+    const { rows } = await database.query(`SELECT 1 FROM participants p JOIN im_channel_bindings b ON b.company_id=p.company_id
+    WHERE p.id=$1 AND p.company_id=$2 AND p.kind='human' AND p.departed_at IS NULL
+      AND b.channel_id=$3 AND b.profile->'members' ? p.id`, [work.principalId, work.tenantId, work.sessionId]);
+    const scopes = [
+        ...(rows.length ? [{ tenantId: work.tenantId, scopeType: 'learner', scopeId: work.principalId }] : []),
+        { tenantId: work.tenantId, scopeType: 'course', scopeId: work.sessionId },
+        { tenantId: work.tenantId, scopeType: 'agent_role', scopeId: work.agentId },
+    ];
+    if (!semantic)
+        return snapshotMemories(await Promise.all(scopes.map(async (scope) => ({ scope, items: await recallMemories(database, scope, '', 12) }))));
+    const saved = await database.query('SELECT request_snapshot FROM lingxios.agent_os_sessions WHERE session_key=$1', [sessionKeyOf(work)]);
+    const request = saved.rows[0]?.['request_snapshot'];
+    const query = (request?.workId === work.id ? `${request.revisions.at(-1)?.text ?? ''}\n${request.originalText}` : String(work.meta?.['text'] ?? '')).slice(0, 2000).replace(/[\uD800-\uDBFF]$/, '');
+    const groups = [];
+    for (const scope of scopes)
+        groups.push({ scope, items: await semantic.recall(work, scope, query, 12) });
+    return snapshotMemories(groups);
+}
+export async function executeMemory(work, action, services, database, semantic) {
+    const method = action.action.slice('memory.'.length);
+    if (!work.principalId || !action.action.startsWith('memory.') || !Object.hasOwn(MEMORY_METHODS, method))
+        throw new Error('unsupported memory action');
+    const allowed = MEMORY_METHODS[method];
+    if (Object.keys(action.args).some(key => !allowed.includes(key)))
+        throw new Error('unknown memory argument');
+    const scopeType = action.args['scope'] ?? 'course';
+    if (scopeType !== 'learner' && scopeType !== 'course' && scopeType !== 'agent_role')
+        throw new Error('invalid memory scope');
+    const learnerId = action.args['learnerId'];
+    if (scopeType !== 'learner' && learnerId !== undefined)
+        throw new Error('learnerId requires learner scope');
+    if (scopeType === 'learner' && (typeof learnerId !== 'string' || !learnerId.trim()))
+        throw new Error('learnerId is required');
+    const write = method !== 'list' && method !== 'recall';
+    await services.permissionService.assertCan({ actorUserId: work.principalId, companyId: work.tenantId,
+        action: write ? 'agent_memory:write' : 'agent_memory:read', resource: { type: 'conversation', id: work.sessionId } });
+    if (scopeType === 'learner') {
+        const { rows } = await database.query(`SELECT 1 FROM participants p JOIN im_channel_bindings b ON b.company_id=p.company_id
+      WHERE p.id=$1 AND p.company_id=$2 AND p.kind='human' AND p.departed_at IS NULL
+        AND b.channel_id=$3 AND b.profile->'members' ? p.id`, [learnerId, work.tenantId, work.sessionId]);
+        if (!rows.length)
+            throw new Error('learner is not an active human member of this conversation');
+    }
+    const scope = { tenantId: work.tenantId, scopeType: scopeType,
+        scopeId: scopeType === 'course' ? work.sessionId : scopeType === 'agent_role' ? work.agentId : learnerId };
+    if (!write) {
+        const query = action.args['query'] ?? '', limit = action.args['limit'] ?? 12;
+        if (typeof query !== 'string' || query.length > 2000 || !Number.isSafeInteger(limit) || Number(limit) < 1 || Number(limit) > 12)
+            throw new Error('invalid memory query or limit');
+        return semantic ? semantic.recall(work, scope, query, Number(limit)) : recallMemories(database, scope, query, Number(limit));
+    }
+    const validUntil = action.args['validUntil'];
+    if (validUntil !== undefined && (typeof validUntil !== 'string' || validUntil.length > 40
+        || !/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.\d{1,3})?(?:Z|[+-]\d\d:\d\d)$/.test(validUntil)
+        || !Number.isFinite(Date.parse(validUntil)) || Date.parse(validUntil) <= Date.now()))
+        throw new Error('validUntil must be a future ISO timestamp');
+    return withTransaction(database, async (client) => {
+        const { rows } = await client.query(`SELECT s.request_snapshot FROM lingxios.agent_work_items w
+      JOIN lingxios.agent_os_sessions s ON s.session_key=$4
+      WHERE w.id=$1 AND w.fence=$2 AND w.status='leased' AND w.lease_expires_at>NOW() AND w.cancel_requested_at IS NULL
+        AND w.principal_id=$3 AND s.request_snapshot->>'workId'=w.id
+        AND jsonb_array_length(s.request_snapshot->'revisions')=jsonb_array_length(w.steer_inputs)
+      FOR UPDATE OF w`, [work.id, work.fence, work.principalId, sessionKeyOf(work)]);
+        const request = rows[0]?.['request_snapshot'];
+        if (!request)
+            throw new Error('memory write requires the current leased request');
+        const source = { workId: work.id, requestVersion: request.revisions.length + 1, sourceRef: request.sourceRef,
+            authorId: request.authorId, inputSha256: createHash('sha256').update(JSON.stringify({ originalText: request.originalText, revisions: request.revisions, attachments: request.attachments })).digest('hex') };
+        if (method === 'note') {
+            const body = action.args['body'], kind = action.args['kind'] ?? 'observation';
+            if (typeof body !== 'string' || !body.trim() || body.length > 2000
+                || typeof kind !== 'string' || !/^[a-z_]{1,32}$/.test(kind))
+                throw new Error('invalid memory body or kind');
+            const id = `mem-${createHash('sha256').update(action.idempotencyKey).digest('hex')}`;
+            const saved = await client.query(`INSERT INTO lingxios.agent_memories
+        (tenant_id,id,scope_type,scope_id,body,kind,origin,source_refs,valid_until)
+        VALUES($1,$2,$3,$4,$5,$6,'explicit',$7::jsonb,$8::timestamptz)
+        ON CONFLICT(tenant_id,id) DO NOTHING RETURNING id,body,kind,origin,version,source_refs,valid_until`, [work.tenantId, id, scopeType, scope.scopeId, body.trim(), kind, JSON.stringify([source]), validUntil ?? null]);
+            if (!saved.rows.length)
+                throw new Error('memory note already exists; reconcile its original action receipt');
+            return saved.rows[0];
+        }
+        const id = action.args['id'], version = action.args['expectedVersion'];
+        if (typeof id !== 'string' || !id || !Number.isSafeInteger(version) || Number(version) < 1)
+            throw new Error('memory changes require id and expectedVersion');
+        if (method === 'delete') {
+            const deleted = await client.query(`DELETE FROM lingxios.agent_memories
+        WHERE tenant_id=$1 AND id=$2 AND scope_type=$3 AND scope_id=$4 AND version=$5 RETURNING id`, [work.tenantId, id, scopeType, scope.scopeId, version]);
+            if (!deleted.rows.length)
+                throw new Error('memory is unavailable or stale');
+            return { id, deleted: true };
+        }
+        if (method === 'pin') {
+            const pinned = action.args['pinned'];
+            if (typeof pinned !== 'boolean')
+                throw new Error('pinned must be a boolean');
+            const saved = await client.query(`UPDATE lingxios.agent_memories SET pinned=$6,version=version+1,
+        source_refs=source_refs||$7::jsonb,updated_at=NOW()
+        WHERE tenant_id=$1 AND id=$2 AND scope_type=$3 AND scope_id=$4 AND version=$5
+          AND jsonb_array_length(source_refs)<64
+        RETURNING id,body,kind,origin,pinned,version,source_refs,valid_until`, [work.tenantId, id, scopeType, scope.scopeId, version, pinned, JSON.stringify([source])]);
+            if (!saved.rows.length)
+                throw new Error('memory is unavailable, stale, or at its provenance limit');
+            return saved.rows[0];
+        }
+        const saved = await client.query(`UPDATE lingxios.agent_memories SET version=version+1,status='active',
+      valid_until=COALESCE($6::timestamptz,valid_until),source_refs=source_refs||$7::jsonb,updated_at=NOW()
+      WHERE tenant_id=$1 AND id=$2 AND scope_type=$3 AND scope_id=$4 AND version=$5 AND origin='explicit'
+        AND jsonb_array_length(source_refs)<64
+        AND (valid_until IS NULL OR valid_until>NOW() OR $6::timestamptz IS NOT NULL)
+      RETURNING id,body,kind,origin,version,source_refs,valid_until`, [work.tenantId, id, scopeType, scope.scopeId, version, validUntil ?? null, JSON.stringify([source])]);
+        if (!saved.rows.length)
+            throw new Error('memory is unavailable, stale, non-explicit, or at its provenance limit');
+        return saved.rows[0];
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/integrations/lingxiloop/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../src/integrations/lingxiloop/memory.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/lingxiloop/polls.d.ts

@@ -0,0 +1,9 @@
+import type { HostAction, WorkItem } from '../../protocol/types.js';
+import type { LingxiLoopServices } from './service-contracts.js';
+export declare const POLL_METHODS: {
+    readonly create: readonly ["question", "mode", "options", "expiresInMinutes"];
+    readonly vote: readonly ["messageId", "optionIds"];
+    readonly close: readonly ["messageId"];
+    readonly show: readonly ["messageId"];
+};
+export declare function executePoll(work: Omit<WorkItem, 'leaseToken'>, action: HostAction, services: Pick<LingxiLoopServices, 'pollApplication' | 'permissionService'>): Promise<unknown>;

package/dist/src/integrations/lingxiloop/polls.js

@@ -0,0 +1,47 @@
+export const POLL_METHODS = { create: ['question', 'mode', 'options', 'expiresInMinutes'], vote: ['messageId', 'optionIds'], close: ['messageId'], show: ['messageId'] };
+export async function executePoll(work, action, services) {
+    const polls = services.pollApplication;
+    const method = action.action.slice('polls.'.length);
+    if (!polls || !work.principalId || !action.action.startsWith('polls.') || !Object.hasOwn(POLL_METHODS, method))
+        throw new Error('unsupported poll action or missing principal');
+    const allowed = POLL_METHODS[method];
+    const args = action.args;
+    if (Object.keys(args).some(key => !allowed.includes(key)))
+        throw new Error('unknown poll argument');
+    const scope = { companyId: work.tenantId, actorId: work.agentId };
+    const messageId = args['messageId'];
+    if (method !== 'create') {
+        if (typeof messageId !== 'string' || !messageId.trim())
+            throw new Error('messageId is required');
+        if (await polls.conversationId(work.tenantId, messageId) !== work.sessionId)
+            throw new Error('poll is outside the authorized conversation');
+    }
+    await services.permissionService.assertCan({ actorUserId: work.principalId, companyId: work.tenantId,
+        action: method === 'show' ? 'poll:read' : method === 'create' ? 'poll:create' : method === 'vote' ? 'poll:vote' : 'poll:close',
+        resource: method === 'create' ? { type: 'conversation', id: work.sessionId } : { type: 'poll', id: messageId },
+    });
+    if (method === 'create') {
+        if (typeof args['question'] !== 'string' || !args['question'].trim() || args['question'].length > 280)
+            throw new Error('invalid poll question');
+        const options = args['options'];
+        if (!Array.isArray(options) || options.length < 2 || options.length > 10 || options.some(value => typeof value !== 'string' || !value.trim() || value.length > 120))
+            throw new Error('invalid poll options');
+        const mode = args['mode'] ?? 'single';
+        if (mode !== 'single' && mode !== 'multi')
+            throw new Error('invalid poll mode');
+        const expires = args['expiresInMinutes'];
+        if (expires != null && (typeof expires !== 'number' || !Number.isFinite(expires) || expires <= 0))
+            throw new Error('invalid poll expiry');
+        return polls.create({ ...scope, conversationId: work.sessionId, question: args['question'], mode, options, expiresInMinutes: (expires ?? null), idempotencyKey: action.idempotencyKey });
+    }
+    if (method === 'vote') {
+        const optionIds = args['optionIds'];
+        if (!Array.isArray(optionIds) || optionIds.length > 10 || optionIds.some(value => typeof value !== 'string' || !value.trim()))
+            throw new Error('invalid vote options');
+        return polls.vote({ ...scope, messageId: messageId, voterKind: 'agent', optionIds });
+    }
+    if (method === 'close')
+        return polls.close({ ...scope, messageId: messageId, reason: 'manual' });
+    return polls.show(work.tenantId, messageId);
+}
+//# sourceMappingURL=polls.js.map

package/dist/src/integrations/lingxiloop/polls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polls.js","sourceRoot":"","sources":["../../../../src/integrations/lingxiloop/polls.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/lingxiloop/presentations.d.ts

@@ -0,0 +1,11 @@
+import type { HostAction, WorkItem } from '../../protocol/types.js';
+import type { LingxiLoopServices } from './service-contracts.js';
+export declare const PRESENTATION_METHODS: {
+    readonly create: readonly ["requirements", "title", "sourceIds", "targetSlideCount", "language"];
+    readonly get: readonly ["presentationId"];
+    readonly cancel: readonly ["presentationId"];
+    readonly retry: readonly ["presentationId"];
+    readonly revise_outline: readonly ["presentationId", "expectedRevision", "feedback", "targetSlideCount"];
+    readonly revise: readonly ["presentationId", "instruction", "scope", "pageIds", "sectionIds"];
+};
+export declare function executePresentation(work: Omit<WorkItem, 'leaseToken'>, action: HostAction, services: LingxiLoopServices): Promise<unknown>;

package/dist/src/integrations/lingxiloop/presentations.js

@@ -0,0 +1,34 @@
+import { nativeWork } from './actions.js';
+export const PRESENTATION_METHODS = {
+    create: ['requirements', 'title', 'sourceIds', 'targetSlideCount', 'language'], get: ['presentationId'],
+    cancel: ['presentationId'], retry: ['presentationId'],
+    revise_outline: ['presentationId', 'expectedRevision', 'feedback', 'targetSlideCount'],
+    revise: ['presentationId', 'instruction', 'scope', 'pageIds', 'sectionIds'],
+};
+export async function executePresentation(work, action, services) {
+    const api = services.presentations;
+    const method = action.action.slice('presentations.'.length);
+    if (!api || !action.action.startsWith('presentations.') || !Object.hasOwn(PRESENTATION_METHODS, method))
+        throw new Error('unsupported or approval-required presentation action');
+    const allowed = PRESENTATION_METHODS[method];
+    if (Object.keys(action.args).some(key => !allowed.includes(key)))
+        throw new Error('unknown presentation argument');
+    const native = nativeWork(work);
+    await services.permissionService.assertCan({ actorUserId: native.authorizationUserId, companyId: native.companyId,
+        action: method === 'get' ? 'knowledge:read' : 'knowledge:write', resource: { type: 'conversation', id: native.channelId }, });
+    if (method === 'create')
+        return api.createPresentationForAgent(native, api.createPresentationRequestSchema.parse({ ...action.args, idempotencyKey: action.idempotencyKey }));
+    const { presentationId, ...args } = action.args;
+    if (typeof presentationId !== 'string' || !presentationId.trim())
+        throw new Error('presentationId is required');
+    const input = { ...args, idempotencyKey: action.idempotencyKey };
+    switch (method) {
+        case 'get': return api.getPresentationForAgent(native, presentationId);
+        case 'cancel': return api.cancelPresentationForAgent(native, presentationId, input);
+        case 'retry': return api.retryPresentationForAgent(native, presentationId, input);
+        case 'revise_outline': return api.revisePresentationOutlineForAgent(native, presentationId, api.revisePresentationOutlineRequestSchema.parse(input));
+        case 'revise': return api.revisePresentationForAgent(native, presentationId, api.revisePresentationRequestSchema.parse(input));
+        default: throw new Error('unsupported presentation action');
+    }
+}
+//# sourceMappingURL=presentations.js.map

package/dist/src/integrations/lingxiloop/presentations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.js","sourceRoot":"","sources":["../../../../src/integrations/lingxiloop/presentations.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/lingxiloop/questionnaire.d.ts

@@ -0,0 +1,21 @@
+export declare function questionnaire(args: Record<string, unknown>): {
+    submitLabel?: string;
+    title: string;
+    items: {
+        input?: {
+            placeholder?: string;
+            label: string;
+        };
+        multiple?: boolean;
+        required?: boolean;
+        description?: string;
+        name: string;
+        prompt: string;
+        choices: {
+            disabled?: boolean;
+            description?: string;
+            value: string;
+            label: string;
+        }[];
+    }[];
+};

package/dist/src/integrations/lingxiloop/questionnaire.js

@@ -0,0 +1,57 @@
+function record(value, fields) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error('questionnaire object required');
+    if (Object.keys(value).some(key => !fields.includes(key)))
+        throw new Error('unknown questionnaire field');
+    return value;
+}
+function text(value, max) {
+    if (typeof value !== 'string' || !value.trim() || value.length > max)
+        throw new Error(`questionnaire text must contain 1..${max} characters`);
+    return value.trim();
+}
+export function questionnaire(args) {
+    const title = args['title'] === undefined ? 'Agent 提问' : text(args['title'], 160);
+    const rawItems = args['items'];
+    if (!Array.isArray(rawItems) || rawItems.length < 1 || rawItems.length > 8)
+        throw new Error('items must contain 1..8 questions');
+    const names = new Set();
+    const items = rawItems.map((raw, index) => {
+        const item = record(raw, ['name', 'prompt', 'description', 'required', 'multiple', 'choices', 'input']);
+        for (const flag of ['required', 'multiple']) {
+            if (item[flag] !== undefined && typeof item[flag] !== 'boolean')
+                throw new Error(`${flag} must be boolean`);
+        }
+        const name = item['name'] === undefined ? `question_${index + 1}` : text(item['name'], 64);
+        if (!/^[A-Za-z][A-Za-z0-9_-]{0,63}$/.test(name) || names.has(name))
+            throw new Error('question names must be unique identifiers');
+        names.add(name);
+        const rawChoices = item['choices'] ?? [];
+        if (!Array.isArray(rawChoices) || rawChoices.length > 12)
+            throw new Error('at most 12 choices per question');
+        const values = new Set();
+        const choices = rawChoices.map(raw => {
+            const choice = record(raw, ['value', 'label', 'description', 'disabled']);
+            if (choice['disabled'] !== undefined && typeof choice['disabled'] !== 'boolean')
+                throw new Error('disabled must be boolean');
+            const value = text(choice['value'], 120);
+            if (values.has(value))
+                throw new Error('duplicate choice value');
+            values.add(value);
+            return { value, label: text(choice['label'], 500),
+                ...(choice['description'] === undefined ? {} : { description: text(choice['description'], 500) }),
+                ...(choice['disabled'] === true ? { disabled: true } : {}),
+            };
+        });
+        const input = item['input'] === undefined ? undefined : record(item['input'], ['label', 'placeholder']);
+        if (!choices.length && !input)
+            throw new Error('question requires choices or freeform input');
+        return { name, prompt: text(item['prompt'], 500), choices,
+            ...(item['description'] === undefined ? {} : { description: text(item['description'], 1000) }),
+            ...(item['required'] === true ? { required: true } : {}), ...(item['multiple'] === true ? { multiple: true } : {}),
+            ...(input ? { input: { label: text(input['label'], 120), ...(input['placeholder'] === undefined ? {} : { placeholder: text(input['placeholder'], 160) }) } } : {}),
+        };
+    });
+    return { title, items, ...(args['submitLabel'] === undefined ? {} : { submitLabel: text(args['submitLabel'], 80) }) };
+}
+//# sourceMappingURL=questionnaire.js.map

package/dist/src/integrations/lingxiloop/questionnaire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questionnaire.js","sourceRoot":"","sources":["../../../../src/integrations/lingxiloop/questionnaire.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/lingxiloop/research.d.ts

@@ -0,0 +1,19 @@
+import type { HostAction, WorkItem } from '../../protocol/types.js';
+import type { LingxiLoopServices } from './service-contracts.js';
+export declare const RESEARCH_METHODS: {
+    readonly search: readonly ["query", "limit"];
+    readonly read: readonly ["url"];
+};
+export declare function executeResearch(work: Omit<WorkItem, 'leaseToken'>, action: HostAction, services: Pick<LingxiLoopServices, 'permissionService'>): Promise<{
+    provider: "OpenAlex";
+    query: string;
+    results: import("../../research/index.js").ResearchSearchResult[];
+} | {
+    url: string;
+    finalUrl: string;
+    contentType: string;
+    text: string;
+    bytes: number;
+    sha256: string;
+    truncated: boolean;
+}>;

package/dist/src/integrations/lingxiloop/research.js

@@ -0,0 +1,20 @@
+import { readResearch, searchResearch } from '../../research/index.js';
+export const RESEARCH_METHODS = { search: ['query', 'limit'], read: ['url'] };
+export async function executeResearch(work, action, services) {
+    const method = action.action.slice('research.'.length);
+    if (!work.principalId || !action.action.startsWith('research.') || !Object.hasOwn(RESEARCH_METHODS, method))
+        throw new Error('unsupported research action or missing principal');
+    const allowed = RESEARCH_METHODS[method];
+    if (Object.keys(action.args).some(key => !allowed.includes(key)))
+        throw new Error('unknown research argument');
+    await services.permissionService.assertCan({ actorUserId: work.principalId, companyId: work.tenantId, action: 'agent:read', resource: { type: 'conversation', id: work.sessionId } });
+    if (method === 'search') {
+        if (typeof action.args['query'] !== 'string' || (action.args['limit'] !== undefined && typeof action.args['limit'] !== 'number'))
+            throw new Error('invalid research search arguments');
+        return searchResearch(action.args['query'], action.args['limit']);
+    }
+    if (typeof action.args['url'] !== 'string')
+        throw new Error('research URL is required');
+    return readResearch(action.args['url']);
+}
+//# sourceMappingURL=research.js.map

package/dist/src/integrations/lingxiloop/research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.js","sourceRoot":"","sources":["../../../../src/integrations/lingxiloop/research.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAGtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAW,CAAA;AAEtF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAkC,EAAE,MAAkB,EAAE,QAAuD;IACnJ,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IACtD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IAChL,MAAM,OAAO,GAAsB,gBAAgB,CAAC,MAAuC,CAAC,CAAA;IAC5F,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC9G,MAAM,QAAQ,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IACrL,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QACtL,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAuB,CAAC,CAAA;IACzF,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IACvF,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;AACzC,CAAC"}