@devoplus/one-sdk 0.0.0-stage → 0.2.0-next.112

package/dist/agentInput.js

@@ -0,0 +1,102 @@
+// Devoplus yapay zekâsının gönderdiği araç girdisini, manifest'te beyan edilen şemaya göre ÇALIŞMA ANINDA doğrular (D-88 b).
+// Şema bir JSON Schema ALT KÜMESİDİR: type · properties · required · enum · minimum · maximum · minLength · maxLength ·
+// items · description. Şemanın kendisinin alt kümeye uyduğunu yayın kapısı (manifest doğrulaması) zaten denetler; burada
+// yalnız GİRDİ denetlenir. Alt küme dışı bir anahtar yine de gelirse (elle kurulmuş manifest) SDK onu yok SAYMAZ, girdiyi
+// reddeder — "denetlendi sanılan ama denetlenmeyen" bir kural bırakılmaz.
+//
+// ⚠️ Nesneler KAPALIDIR: şemada olmayan alan reddedilir (`additionalProperties: false` örtük). Model bir alan uydurursa
+// işleyici onu hiç görmez; hata metni ajana hangi alanların geçerli olduğunu söyler.
+//
+// Anahtar listesi manifest paketindeki `AGENT_INPUT_KEYWORDS` ile birebirdir (SDK testi kilitler).
+export const AGENT_INPUT_KEYWORDS = ['type', 'properties', 'required', 'enum', 'minimum', 'maximum', 'minLength', 'maxLength', 'items', 'description'];
+/** Rapor tavanı: model bozuk bir girdi gönderdiğinde yanıt şişmesin. */
+const MAX_ERRORS = 20;
+const KEYWORDS = new Set(AGENT_INPUT_KEYWORDS);
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function at(path, key) {
+    return path ? `${path}.${key}` : String(key);
+}
+function describe(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'dizi';
+    return typeof value;
+}
+/** Girdiyi şemaya göre denetler; boş dizi = geçerli. */
+export function validateAgentInput(schema, input) {
+    const errors = [];
+    check(schema, input, '', errors);
+    return errors.slice(0, MAX_ERRORS);
+}
+function check(schema, value, path, out) {
+    if (out.length >= MAX_ERRORS)
+        return;
+    const where = path || '(kök)';
+    if (!isPlainObject(schema)) {
+        out.push({ path: where, message: 'araç şeması geçersiz' });
+        return;
+    }
+    for (const key of Object.keys(schema))
+        if (!KEYWORDS.has(key)) {
+            out.push({ path: where, message: `araç şeması desteklenmeyen "${key}" anahtarını taşıyor` });
+            return;
+        }
+    switch (schema.type) {
+        case 'string':
+            if (typeof value !== 'string')
+                return void out.push({ path: where, message: `metin bekleniyordu, ${describe(value)} geldi` });
+            if (typeof schema.minLength === 'number' && value.length < schema.minLength)
+                out.push({ path: where, message: `en az ${schema.minLength} karakter olmalı` });
+            if (typeof schema.maxLength === 'number' && value.length > schema.maxLength)
+                out.push({ path: where, message: `en çok ${schema.maxLength} karakter olabilir` });
+            break;
+        case 'number':
+        case 'integer':
+            if (typeof value !== 'number' || !Number.isFinite(value))
+                return void out.push({ path: where, message: `sayı bekleniyordu, ${describe(value)} geldi` });
+            if (schema.type === 'integer' && !Number.isSafeInteger(value))
+                out.push({ path: where, message: 'tam sayı olmalı' });
+            if (typeof schema.minimum === 'number' && value < schema.minimum)
+                out.push({ path: where, message: `en az ${schema.minimum} olmalı` });
+            if (typeof schema.maximum === 'number' && value > schema.maximum)
+                out.push({ path: where, message: `en çok ${schema.maximum} olabilir` });
+            break;
+        case 'boolean':
+            if (typeof value !== 'boolean')
+                return void out.push({ path: where, message: `true/false bekleniyordu, ${describe(value)} geldi` });
+            break;
+        case 'array': {
+            if (!Array.isArray(value))
+                return void out.push({ path: where, message: `dizi bekleniyordu, ${describe(value)} geldi` });
+            value.forEach((item, i) => check(schema.items, item, at(path, i), out));
+            break;
+        }
+        case 'object': {
+            if (!isPlainObject(value))
+                return void out.push({ path: where, message: `nesne bekleniyordu, ${describe(value)} geldi` });
+            const props = isPlainObject(schema.properties) ? schema.properties : {};
+            const required = Array.isArray(schema.required) ? schema.required.filter((r) => typeof r === 'string') : [];
+            for (const name of required)
+                if (!(name in value) || value[name] === undefined)
+                    out.push({ path: at(path, name), message: 'zorunlu alan eksik' });
+            const known = Object.keys(props);
+            for (const [name, v] of Object.entries(value)) {
+                if (!Object.hasOwn(props, name)) {
+                    out.push({ path: at(path, name), message: `bilinmeyen alan; geçerli alanlar: ${known.length ? known.join(', ') : '(yok)'}` });
+                    continue;
+                }
+                check(props[name], v, at(path, name), out);
+            }
+            break;
+        }
+        default:
+            out.push({ path: where, message: 'araç şemasında "type" geçersiz' });
+            return;
+    }
+    if (Array.isArray(schema.enum) && !schema.enum.some((e) => e === value))
+        out.push({ path: where, message: `şu değerlerden biri olmalı: ${schema.enum.map((e) => JSON.stringify(e)).join(', ')}` });
+}
+//# sourceMappingURL=agentInput.js.map

package/dist/agentInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentInput.js","sourceRoot":"","sources":["../src/agentInput.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAC7H,wHAAwH;AACxH,yHAAyH;AACzH,0HAA0H;AAC1H,0EAA0E;AAC1E,EAAE;AACF,wHAAwH;AACxH,qFAAqF;AACrF,EAAE;AACF,mGAAmG;AAEnG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,CAAU,CAAA;AAQ/J,wEAAwE;AACxE,MAAM,UAAU,GAAG,EAAE,CAAA;AACrB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,oBAAoB,CAAC,CAAA;AAEtD,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,EAAE,CAAC,IAAY,EAAE,GAAoB;IAC5C,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;AAC9C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAA;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAA;IACvC,OAAO,OAAO,KAAK,CAAA;AACrB,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,kBAAkB,CAAC,MAAe,EAAE,KAAc;IAChE,MAAM,MAAM,GAAsB,EAAE,CAAA;IACpC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;AACpC,CAAC;AAED,SAAS,KAAK,CAAC,MAAe,EAAE,KAAc,EAAE,IAAY,EAAE,GAAsB;IAClF,IAAI,GAAG,CAAC,MAAM,IAAI,UAAU;QAAE,OAAM;IACpC,MAAM,KAAK,GAAG,IAAI,IAAI,OAAO,CAAA;IAC7B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAA;QAC1D,OAAM;IACR,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,+BAA+B,GAAG,sBAAsB,EAAE,CAAC,CAAA;YAC5F,OAAM;QACR,CAAC;IAEH,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,uBAAuB,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;YAC7H,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS;gBACzE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,MAAM,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAA;YACjF,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS;gBACzE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,MAAM,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAA;YACpF,MAAK;QACP,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACtD,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;YAC/F,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAA;YACpH,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,MAAM,CAAC,OAAO,SAAS,EAAE,CAAC,CAAA;YACtI,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,MAAM,CAAC,OAAO,WAAW,EAAE,CAAC,CAAA;YACzI,MAAK;QACP,KAAK,SAAS;YACZ,IAAI,OAAO,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,4BAA4B,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;YACnI,MAAK;QACP,KAAK,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;YACxH,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;YACvE,MAAK;QACP,CAAC;QACD,KAAK,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,uBAAuB,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;YACzH,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;YACvE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YACxH,KAAK,MAAM,IAAI,IAAI,QAAQ;gBACzB,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS;oBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAA;YACtH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAChC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;oBAChC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,qCAAqC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;oBAC7H,SAAQ;gBACV,CAAC;gBACD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAA;YAC5C,CAAC;YACD,MAAK;QACP,CAAC;QACD;YACE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC,CAAA;YACpE,OAAM;IACV,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC;QACrE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,+BAA+B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;AAC7H,CAAC"}

package/dist/agentTools.d.ts

@@ -0,0 +1,83 @@
+import { type OneContext } from './context.ts';
+/** Platformun uygulamaya ayırdığı yol öneki (yalnız imzalı ajan çağrısı ulaşır). */
+export declare const AGENT_PATH_PREFIX = "/__one/agent/";
+/** Platform kapısının imzalı ajan çağrısında yazdığı başlık ve değeri. */
+export declare const AGENT_INVOKED_BY_HEADER = "x-one-invoked-by";
+export declare const AGENT_INVOKED_BY = "devoplus-agent";
+/** Uygulamanın ajan kataloğu (manifest `agent` bölümü + uygulama adı) ve ajan rehberi (`AGENT_GUIDE.md`). */
+export declare const AGENT_CATALOG_PATH = "/.well-known/one-agent.json";
+export declare const AGENT_GUIDE_PATH = "/.well-known/one-agent.md";
+/** Araç çağrısı gövdesi tavanı (platform kapısıyla aynı). */
+export declare const AGENT_BODY_MAX_BYTES: number;
+/** Rehber tavanı (Devoplus'ın okuduğu en çok boyut). */
+export declare const AGENT_GUIDE_MAX_BYTES: number;
+/** Araç adı biçimi (manifest `AGENT_TOOL_NAME_RE` ile birebir; SDK testi kilitler). */
+export declare const AGENT_TOOL_NAME_RE: RegExp;
+interface Localized {
+    tr: string;
+    en?: string;
+}
+/** Manifest'in SDK'nın okuduğu kısmı (uygulama `one.manifest.json`'u doğrudan verir). */
+export interface AgentManifest {
+    app: {
+        slug: string;
+        name: Localized;
+    };
+    agent?: {
+        summary: Localized;
+        tools?: ReadonlyArray<{
+            name: string;
+            title: Localized;
+            description: Localized;
+            readOnly: boolean;
+            permission?: string;
+            input: unknown;
+        }>;
+    };
+}
+export interface AgentToolCall<Env> {
+    /** Şemaya göre doğrulanmış girdi. */
+    input: Record<string, unknown>;
+    /**
+     * Kullanıcının kimlik bağlamı (araç kullanıcının adına çalışır; `ctx.user` her zaman doludur, `ctx.mode` `'agent'`).
+     * `ctx.admin`: çağıran kişi kurulumun portalının şirket yöneticisi (`hasPermission` her kodda `true`). `ctx.actor`:
+     * Vekalet / Yerine Görüntüle oturumunda işlemi yapan kişi (değişiklik yapan araç o oturumda zaten çağrılamaz).
+     * Devoplus servisleri (yapay zekâ, DEXA okuma, kişiler…) kişi adına çağrılabilir; süreli onay gerektirenler (e-posta,
+     * SMS, mobil bildirim, DEXA'ya yazma) ajan aracında KULLANILAMAZ.
+     */
+    ctx: OneContext;
+    env: Env;
+}
+export interface AgentToolDefinition<Env> {
+    /** JSON'a çevrilebilir bir değer döndürür; Devoplus ajanı bunu okur. Kişisel veriyi yalnız iş gerektiriyorsa döndürün. */
+    handler(call: AgentToolCall<Env>): unknown | Promise<unknown>;
+}
+export type AgentTools<Env> = Readonly<Record<string, AgentToolDefinition<Env>>>;
+/** Araç işleyicilerini tanımlar; adlar manifest `agent.tools[].name` ile AYNI olmalıdır. Biçimsiz ad hemen fırlatır. */
+export declare function defineAgentTools<Env>(tools: Record<string, AgentToolDefinition<Env>>): AgentTools<Env>;
+/**
+ * Yol `/__one/agent/` ile başlamıyorsa `null` (uygulama kendi yönlendirmesine devam eder); başlıyorsa yanıt üretir.
+ */
+export declare function handleAgentRequest<Env>(request: Request, env: Env, tools: AgentTools<Env>, manifest: AgentManifest): Promise<Response | null>;
+/** `/.well-known/one-agent.json` gövdesi: uygulamanın kısa adı + adı + `agent` bölümü. Başka alan YOKTUR. */
+export declare function agentCatalog(manifest: AgentManifest): {
+    app: {
+        slug: string;
+        name: Localized;
+    };
+    agent: {
+        summary: Localized;
+        tools: unknown[];
+    };
+} | null;
+/**
+ * `GET /.well-known/one-agent.json` (ajan kataloğu) ve `GET /.well-known/one-agent.md` (ajan rehberi `AGENT_GUIDE.md`)
+ * yanıtlarını üretir; başka yol ya da yöntem için `null`. Oturum İSTEMEZ (Devoplus kataloğu oturumsuz okur; içerik
+ * zaten manifest ve rehberdir — kullanıcı verisi taşımaz). Manifest `agent` bölümü yoksa ya da rehber boşsa 404.
+ *
+ * Rehber derlemede gömülür: `import guide from '../AGENT_GUIDE.md' with { type: 'text' }` (`one build` ve yayın aynı
+ * paketleyiciyi kullanır).
+ */
+export declare function agentManifestResponse(request: Request, manifest: AgentManifest, guide: string): Response | null;
+export {};
+//# sourceMappingURL=agentTools.d.ts.map

package/dist/agentTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTools.d.ts","sourceRoot":"","sources":["../src/agentTools.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAqD,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAKjG,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,kBAAkB,CAAA;AAChD,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,qBAAqB,CAAA;AACzD,eAAO,MAAM,gBAAgB,mBAAmB,CAAA;AAChD,6GAA6G;AAC7G,eAAO,MAAM,kBAAkB,gCAAgC,CAAA;AAC/D,eAAO,MAAM,gBAAgB,8BAA8B,CAAA;AAC3D,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,QAAa,CAAA;AAC9C,wDAAwD;AACxD,eAAO,MAAM,qBAAqB,QAAa,CAAA;AAC/C,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,QAA2B,CAAA;AAE1D,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAAA;IACtC,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,SAAS,CAAA;QAClB,KAAK,CAAC,EAAE,aAAa,CAAC;YACpB,IAAI,EAAE,MAAM,CAAA;YACZ,KAAK,EAAE,SAAS,CAAA;YAChB,WAAW,EAAE,SAAS,CAAA;YACtB,QAAQ,EAAE,OAAO,CAAA;YACjB,UAAU,CAAC,EAAE,MAAM,CAAA;YACnB,KAAK,EAAE,OAAO,CAAA;SACf,CAAC,CAAA;KACH,CAAA;CACF;AAED,MAAM,WAAW,aAAa,CAAC,GAAG;IAChC,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B;;;;;;OAMG;IACH,GAAG,EAAE,UAAU,CAAA;IACf,GAAG,EAAE,GAAG,CAAA;CACT;AAED,MAAM,WAAW,mBAAmB,CAAC,GAAG;IACtC,0HAA0H;IAC1H,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9D;AAED,MAAM,MAAM,UAAU,CAAC,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAEhF,wHAAwH;AACxH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAOtG;AAaD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAC1C,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA6C1B;AAED,6GAA6G;AAC7G,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG;IAAE,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC;IAAC,KAAK,EAAE;QAAE,OAAO,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAA;CAAE,GAAG,IAAI,CAaxJ;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAoB/G"}

package/dist/agentTools.js

@@ -0,0 +1,164 @@
+// Devoplus yapay zekâsı → uygulama (karar defteri D-88 b/c — ÖNERİ). Devoplus ajanı, kullanıcının kendi oturumuyla
+// Devoplus'a gelir; Devoplus kurulumu, uygulama iznini ve aracın beyanını denetleyip isteği platform kapısına İMZALI
+// iletir; kapı imzayı doğrular ve isteği uygulamaya `POST /__one/agent/<araç>` olarak, KULLANICININ kimliğiyle verir.
+// Yani araç, kullanıcının uygulamanın ekranında yapabileceğinden fazlasını yapamaz.
+//
+// Uygulama tarafı:
+//   const tools = defineAgentTools<Env>({ 'list-notes': { handler: async ({ input, ctx, env }) => ({ notes: [] }) } })
+//   export default { async fetch(request, env) {
+//     const agent = (await handleAgentRequest(request, env, tools, manifest)) ?? agentManifestResponse(request, manifest, guide)
+//     if (agent) return agent
+//     …
+//   } }
+//
+// Araçların ADI, açıklaması, girdi şeması, `readOnly` ve izni manifest `agent.tools[]`'tadır (tek kaynak); burada yalnız
+// işleyici yazılır. Manifest'te beyan edilmeyen araç çağrılamaz (404) — kodda tanımlı olsa bile.
+//
+// SDK'nın kapıları (sırayla): yol `/__one/agent/<ad>` · `X-One-Invoked-By: devoplus-agent` (yalnız platform kapısının
+// imzalı yolu yazar; tarayıcıdan gelen aynı başlık kapıda silinir) · yalnız POST · araç manifest'te VE kodda · oturum ·
+// `readOnly: false` araç Vekalet / Yerine Görüntüle oturumunda KAPALI · aracın izni · girdi şemaya uygun. Bu kapılar
+// platformunkilerin YERİNE değil YANINDADIR (savunma derinliği).
+import { OneError, hasPermission, readContext, requireUser } from './context.js';
+import { validateAgentInput } from './agentInput.js';
+import { readBoundedBody } from './files.js';
+import { problemResponse } from './problem.js';
+/** Platformun uygulamaya ayırdığı yol öneki (yalnız imzalı ajan çağrısı ulaşır). */
+export const AGENT_PATH_PREFIX = '/__one/agent/';
+/** Platform kapısının imzalı ajan çağrısında yazdığı başlık ve değeri. */
+export const AGENT_INVOKED_BY_HEADER = 'x-one-invoked-by';
+export const AGENT_INVOKED_BY = 'devoplus-agent';
+/** Uygulamanın ajan kataloğu (manifest `agent` bölümü + uygulama adı) ve ajan rehberi (`AGENT_GUIDE.md`). */
+export const AGENT_CATALOG_PATH = '/.well-known/one-agent.json';
+export const AGENT_GUIDE_PATH = '/.well-known/one-agent.md';
+/** Araç çağrısı gövdesi tavanı (platform kapısıyla aynı). */
+export const AGENT_BODY_MAX_BYTES = 256 * 1024;
+/** Rehber tavanı (Devoplus'ın okuduğu en çok boyut). */
+export const AGENT_GUIDE_MAX_BYTES = 256 * 1024;
+/** Araç adı biçimi (manifest `AGENT_TOOL_NAME_RE` ile birebir; SDK testi kilitler). */
+export const AGENT_TOOL_NAME_RE = /^[a-z][a-z0-9-]{1,39}$/;
+/** Araç işleyicilerini tanımlar; adlar manifest `agent.tools[].name` ile AYNI olmalıdır. Biçimsiz ad hemen fırlatır. */
+export function defineAgentTools(tools) {
+    for (const [name, def] of Object.entries(tools)) {
+        if (!AGENT_TOOL_NAME_RE.test(name))
+            throw new OneError(500, 'ONE-SDK-E-090', `Araç adı geçersiz: "${name}" (küçük harfle başlar, küçük harf/rakam/"-", 2-40 karakter).`);
+        if (!def || typeof def.handler !== 'function')
+            throw new OneError(500, 'ONE-SDK-E-090', `"${name}" aracının işleyicisi (handler) yok.`);
+    }
+    return Object.freeze({ ...tools });
+}
+function agentNotFound() {
+    // Kapıların hepsi AYNI yanıtı verir: araç adı yoklanamaz, "var ama size kapalı" sızmaz.
+    return problemResponse(new OneError(404, 'ONE-SDK-E-091', 'Bulunamadı.'));
+}
+/** Girdi hatası: alan yollarıyla 400 (ajan düzeltip yeniden dener). */
+function inputProblem(errors) {
+    const body = { type: 'about:blank', title: 'ONE-SDK-E-094', status: 400, detail: 'Araç girdisi geçersiz.', code: 'ONE-SDK-E-094', errors };
+    return new Response(JSON.stringify(body), { status: 400, headers: { 'content-type': 'application/problem+json; charset=utf-8' } });
+}
+/**
+ * Yol `/__one/agent/` ile başlamıyorsa `null` (uygulama kendi yönlendirmesine devam eder); başlıyorsa yanıt üretir.
+ */
+export async function handleAgentRequest(request, env, tools, manifest) {
+    const pathname = new URL(request.url).pathname;
+    if (!pathname.startsWith(AGENT_PATH_PREFIX))
+        return null;
+    if (request.headers.get(AGENT_INVOKED_BY_HEADER) !== AGENT_INVOKED_BY)
+        return agentNotFound();
+    if (request.method !== 'POST')
+        return agentNotFound();
+    const name = pathname.slice(AGENT_PATH_PREFIX.length);
+    if (!AGENT_TOOL_NAME_RE.test(name))
+        return agentNotFound();
+    const declared = manifest.agent?.tools?.find((t) => t.name === name);
+    if (!declared)
+        return agentNotFound();
+    const tool = Object.hasOwn(tools, name) ? tools[name] : undefined;
+    let ctx;
+    try {
+        if (!tool)
+            throw new OneError(501, 'ONE-SDK-E-092', `"${name}" aracı manifest'te beyan edilmiş ama işleyicisi tanımlanmamış (defineAgentTools).`);
+        ctx = readContext(request.headers);
+        requireUser(ctx);
+        if (!declared.readOnly && ctx.actor)
+            throw new OneError(403, 'ONE-SDK-E-095', 'Bu araç değişiklik yapar; Vekalet ya da Yerine Görüntüle oturumunda kullanılamaz. Değişiklik için kendi hesabınıza dönün.');
+        if (declared.permission && !hasPermission(ctx, declared.permission))
+            throw new OneError(403, 'ONE-SDK-E-004', `Bu araç için "${declared.permission}" izni gerekir.`);
+        let raw;
+        try {
+            raw = await readBoundedBody(request, AGENT_BODY_MAX_BYTES);
+        }
+        catch {
+            throw new OneError(413, 'ONE-SDK-E-093', `Araç girdisi en çok ${AGENT_BODY_MAX_BYTES} bayt olabilir.`);
+        }
+        const text = new TextDecoder().decode(raw);
+        let input = {};
+        if (text.trim()) {
+            try {
+                input = JSON.parse(text);
+            }
+            catch {
+                throw new OneError(400, 'ONE-SDK-E-093', 'Araç girdisi geçerli JSON değil.');
+            }
+        }
+        const errors = validateAgentInput(declared.input, input);
+        if (errors.length > 0)
+            return inputProblem(errors);
+        const result = await tool.handler({ input: input, ctx, env });
+        return new Response(JSON.stringify(result ?? null), {
+            headers: { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' },
+        });
+    }
+    catch (error) {
+        return problemResponse(error, ctx);
+    }
+}
+/** `/.well-known/one-agent.json` gövdesi: uygulamanın kısa adı + adı + `agent` bölümü. Başka alan YOKTUR. */
+export function agentCatalog(manifest) {
+    if (!manifest.agent)
+        return null;
+    return {
+        app: { slug: manifest.app.slug, name: manifest.app.name },
+        agent: {
+            summary: manifest.agent.summary,
+            tools: (manifest.agent.tools ?? []).map((t) => {
+                const tool = { name: t.name, title: t.title, description: t.description, readOnly: t.readOnly, input: t.input };
+                if (t.permission)
+                    tool.permission = t.permission;
+                return tool;
+            }),
+        },
+    };
+}
+/**
+ * `GET /.well-known/one-agent.json` (ajan kataloğu) ve `GET /.well-known/one-agent.md` (ajan rehberi `AGENT_GUIDE.md`)
+ * yanıtlarını üretir; başka yol ya da yöntem için `null`. Oturum İSTEMEZ (Devoplus kataloğu oturumsuz okur; içerik
+ * zaten manifest ve rehberdir — kullanıcı verisi taşımaz). Manifest `agent` bölümü yoksa ya da rehber boşsa 404.
+ *
+ * Rehber derlemede gömülür: `import guide from '../AGENT_GUIDE.md' with { type: 'text' }` (`one build` ve yayın aynı
+ * paketleyiciyi kullanır).
+ */
+export function agentManifestResponse(request, manifest, guide) {
+    if (request.method !== 'GET' && request.method !== 'HEAD')
+        return null;
+    const pathname = new URL(request.url).pathname;
+    const headers = { 'cache-control': 'public, max-age=300', 'x-content-type-options': 'nosniff' };
+    if (pathname === AGENT_CATALOG_PATH) {
+        const catalog = agentCatalog(manifest);
+        if (!catalog)
+            return agentNotFound();
+        return new Response(request.method === 'HEAD' ? null : JSON.stringify(catalog), {
+            headers: { ...headers, 'content-type': 'application/json; charset=utf-8' },
+        });
+    }
+    if (pathname === AGENT_GUIDE_PATH) {
+        if (!manifest.agent || !guide.trim())
+            return agentNotFound();
+        if (new TextEncoder().encode(guide).byteLength > AGENT_GUIDE_MAX_BYTES)
+            return problemResponse(new OneError(500, 'ONE-SDK-E-096', `Ajan rehberi en çok ${AGENT_GUIDE_MAX_BYTES} bayt olabilir.`));
+        return new Response(request.method === 'HEAD' ? null : guide, {
+            headers: { ...headers, 'content-type': 'text/markdown; charset=utf-8' },
+        });
+    }
+    return null;
+}
+//# sourceMappingURL=agentTools.js.map

package/dist/agentTools.js.map

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

package/dist/ai.d.ts

@@ -0,0 +1,67 @@
+import type { BackendClient } from './backend.ts';
+import { type OneContext } from './context.ts';
+export declare const AI_SCOPE = "ai.use";
+export declare const AI_TASKS: readonly ['summarize', 'classify', 'extract', 'generate', 'chat'];
+export declare const AI_INPUT_MAX_LENGTH = 24000;
+export declare const AI_INSTRUCTIONS_MAX_LENGTH = 4000;
+export declare const AI_LABELS_MAX = 50;
+/** Bir sınıf etiketinin en çok karakteri (ÖNERİ — sunucu sözleşmesinde tanımlı değil; dar taraf seçildi). */
+export declare const AI_LABEL_MAX_LENGTH = 100;
+export declare const AI_SCHEMA_MAX_BYTES: number;
+export declare const AI_MESSAGES_MAX = 20;
+export type OneAiTask = (typeof AI_TASKS)[number];
+export interface OneAiMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface OneAiRequest {
+    /** İş: özet · sınıflandırma (`labels` ister) · alan çıkarma (`schema` ister) · metin üretme · sohbet (`messages`). */
+    task: OneAiTask;
+    /** İşlenecek metin (1-24.000 karakter). */
+    input: string;
+    /** Ek talimat (ör. "üç maddede, resmî dille"); ≤ 4.000 karakter. */
+    instructions?: string;
+    /** Yanıt dili; verilmezse sunucu karar verir. */
+    lang?: 'tr' | 'en';
+    /** Yalnız `classify`: seçilebilecek etiketler (2-50, tekil). */
+    labels?: readonly string[];
+    /** Yalnız `extract`: çıkarılacak alanların JSON şeması (nesne, ≤ 8 KiB). */
+    schema?: Record<string, unknown>;
+    /** Yalnız `chat`: önceki konuşma (en çok 20 ileti). */
+    messages?: readonly OneAiMessage[];
+}
+export interface OneAiResult {
+    /** Modelin metin çıktısı. */
+    output: string;
+    /** `extract` sonucunun ayrıştırılmış hâli (sunucu verdiyse). */
+    json?: unknown;
+    /** `classify` sonucunda seçilen etiket (sunucu verdiyse; her zaman `labels` içinden). */
+    label?: string;
+    /** Sunucunun seçtiği model. */
+    model: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/** Sunucuya giden gövdeyi doğrular ve kurar; hatalı girdi fırlatır (istek hiç gitmez). */
+export declare function buildAiRequest(request: OneAiRequest): Record<string, unknown>;
+/**
+ * Yanıtı sözleşmeye indirger. `output` metin değilse ya da `model` yoksa yanıt TANINMAZ ve `ONE-SDK-E-086` fırlatılır —
+ * bilinmeyen bir yanıtı boş bir öneri gibi göstermek uygulamayı yanlış bir karara götürürdü.
+ */
+export declare function normalizeAiResult(raw: unknown): OneAiResult;
+/**
+ * Devoplus yapay zekâsına bir iş gönderir (`POST One/services/ai`, scope `ai.use`). Kullanıcı, portal ve uygulama
+ * istekle GÖNDERİLMEZ — backend bunları doğrulanmış platform bağlamından alır.
+ *
+ * ```ts
+ * const { output } = await completeAi(api, ctx, { task: 'summarize', input: metin, lang: 'tr' })
+ * ```
+ */
+export declare function completeAi(api: Pick<BackendClient, 'request'>, ctx: OneContext, request: OneAiRequest): Promise<OneAiResult>;
+/** `ai.complete(api, ctx, istek)` — `completeAi` ile aynı. */
+export declare const ai: {
+    readonly complete: typeof completeAi;
+};
+//# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAiC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAE7E,eAAO,MAAM,QAAQ,WAAW,CAAA;AAChC,eAAO,MAAM,QAAQ,YAAI,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAU,CAAA;AACzF,eAAO,MAAM,mBAAmB,QAAS,CAAA;AACzC,eAAO,MAAM,0BAA0B,OAAQ,CAAA;AAC/C,eAAO,MAAM,aAAa,KAAK,CAAA;AAC/B,6GAA6G;AAC7G,eAAO,MAAM,mBAAmB,MAAM,CAAA;AACtC,eAAO,MAAM,mBAAmB,QAAW,CAAA;AAC3C,eAAO,MAAM,eAAe,KAAK,CAAA;AAEjC,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,sHAAsH;IACtH,IAAI,EAAE,SAAS,CAAA;IACf,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,gEAAgE;IAChE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;CACrD;AAUD,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8D7E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAc3D;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAMlI;AAED,8DAA8D;AAC9D,eAAO,MAAM,EAAE;aAAK,QAAQ;CAAuB,CAAA"}

package/dist/ai.js

@@ -0,0 +1,129 @@
+import { OneError, requireServiceScope } from './context.js';
+export const AI_SCOPE = 'ai.use';
+export const AI_TASKS = ['summarize', 'classify', 'extract', 'generate', 'chat'];
+export const AI_INPUT_MAX_LENGTH = 24_000;
+export const AI_INSTRUCTIONS_MAX_LENGTH = 4_000;
+export const AI_LABELS_MAX = 50;
+/** Bir sınıf etiketinin en çok karakteri (ÖNERİ — sunucu sözleşmesinde tanımlı değil; dar taraf seçildi). */
+export const AI_LABEL_MAX_LENGTH = 100;
+export const AI_SCHEMA_MAX_BYTES = 8 * 1024;
+export const AI_MESSAGES_MAX = 20;
+function fail(code, detail, status = 400) {
+    throw new OneError(status, code, detail);
+}
+function utf8Bytes(text) {
+    return new TextEncoder().encode(text).byteLength;
+}
+/** Sunucuya giden gövdeyi doğrular ve kurar; hatalı girdi fırlatır (istek hiç gitmez). */
+export function buildAiRequest(request) {
+    if (request === null || typeof request !== 'object')
+        fail('ONE-SDK-E-080', 'Yapay zekâ isteği bir nesne olmalıdır.');
+    const { task } = request;
+    if (!AI_TASKS.includes(task))
+        fail('ONE-SDK-E-080', `Yapay zekâ işi şunlardan biri olmalıdır: ${AI_TASKS.join(', ')}.`);
+    if (typeof request.input !== 'string' || request.input.trim().length === 0)
+        fail('ONE-SDK-E-081', 'Yapay zekâya gönderilecek metin (input) boş olamaz.');
+    if (request.input.length > AI_INPUT_MAX_LENGTH)
+        fail('ONE-SDK-E-081', `Yapay zekâya gönderilecek metin en çok ${AI_INPUT_MAX_LENGTH} karakter olabilir (${request.input.length}).`, 413);
+    const body = { task, input: request.input };
+    if (request.instructions !== undefined) {
+        if (typeof request.instructions !== 'string' || request.instructions.length > AI_INSTRUCTIONS_MAX_LENGTH)
+            fail('ONE-SDK-E-082', `Talimat (instructions) en çok ${AI_INSTRUCTIONS_MAX_LENGTH} karakterlik metin olabilir.`);
+        if (request.instructions.trim())
+            body.instructions = request.instructions;
+    }
+    if (request.lang !== undefined) {
+        if (request.lang !== 'tr' && request.lang !== 'en')
+            fail('ONE-SDK-E-082', 'Yanıt dili (lang) "tr" ya da "en" olmalıdır.');
+        body.lang = request.lang;
+    }
+    if (task === 'classify') {
+        const labels = request.labels;
+        if (!Array.isArray(labels) || labels.length < 2 || labels.length > AI_LABELS_MAX)
+            fail('ONE-SDK-E-083', `Sınıflandırma için 2-${AI_LABELS_MAX} etiket (labels) verilmelidir.`);
+        const seen = new Set();
+        for (const label of labels) {
+            if (typeof label !== 'string' || label.trim().length === 0 || label.length > AI_LABEL_MAX_LENGTH)
+                fail('ONE-SDK-E-083', `Her etiket 1-${AI_LABEL_MAX_LENGTH} karakterlik metin olmalıdır.`);
+            if (seen.has(label))
+                fail('ONE-SDK-E-083', `"${label}" etiketi birden çok kez yazılmış.`);
+            seen.add(label);
+        }
+        body.labels = [...labels];
+    }
+    else if (request.labels !== undefined)
+        fail('ONE-SDK-E-083', 'Etiketler (labels) yalnız "classify" işinde verilir.');
+    if (task === 'extract') {
+        const schema = request.schema;
+        if (schema === null || typeof schema !== 'object' || Array.isArray(schema))
+            fail('ONE-SDK-E-084', 'Alan çıkarma için çıkarılacak alanların şeması (schema) bir JSON nesnesi olarak verilmelidir.');
+        let serialized;
+        try {
+            serialized = JSON.stringify(schema);
+        }
+        catch {
+            fail('ONE-SDK-E-084', 'Şema (schema) JSON\'a çevrilemiyor.');
+        }
+        const bytes = utf8Bytes(serialized);
+        if (bytes > AI_SCHEMA_MAX_BYTES)
+            fail('ONE-SDK-E-084', `Şema (schema) en çok ${AI_SCHEMA_MAX_BYTES} bayt olabilir (${bytes}).`, 413);
+        body.schema = schema;
+    }
+    else if (request.schema !== undefined)
+        fail('ONE-SDK-E-084', 'Şema (schema) yalnız "extract" işinde verilir.');
+    if (task === 'chat') {
+        const messages = request.messages ?? [];
+        if (!Array.isArray(messages) || messages.length > AI_MESSAGES_MAX)
+            fail('ONE-SDK-E-085', `Sohbet geçmişi (messages) en çok ${AI_MESSAGES_MAX} ileti olabilir.`);
+        for (const m of messages) {
+            if (m === null || typeof m !== 'object' || (m.role !== 'user' && m.role !== 'assistant') || typeof m.content !== 'string' || !m.content.trim())
+                fail('ONE-SDK-E-085', 'Her sohbet iletisi { role: "user" | "assistant", content: dolu metin } olmalıdır.');
+        }
+        if (messages.length > 0)
+            body.messages = messages.map((m) => ({ role: m.role, content: m.content }));
+    }
+    else if (request.messages !== undefined)
+        fail('ONE-SDK-E-085', 'Sohbet geçmişi (messages) yalnız "chat" işinde verilir.');
+    return body;
+}
+/**
+ * Yanıtı sözleşmeye indirger. `output` metin değilse ya da `model` yoksa yanıt TANINMAZ ve `ONE-SDK-E-086` fırlatılır —
+ * bilinmeyen bir yanıtı boş bir öneri gibi göstermek uygulamayı yanlış bir karara götürürdü.
+ */
+export function normalizeAiResult(raw) {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+        fail('ONE-SDK-E-086', 'Yapay zekâ yanıtı tanınmadı.', 502);
+    const r = raw;
+    if (typeof r.output !== 'string' || typeof r.model !== 'string')
+        fail('ONE-SDK-E-086', 'Yapay zekâ yanıtı tanınmadı.', 502);
+    const usage = (r.usage ?? {});
+    const count = (v) => (typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : 0);
+    const result = {
+        output: r.output,
+        model: r.model,
+        usage: { inputTokens: count(usage.inputTokens), outputTokens: count(usage.outputTokens) },
+    };
+    if ('json' in r && r.json !== undefined)
+        result.json = r.json;
+    if (typeof r.label === 'string')
+        result.label = r.label;
+    return result;
+}
+/**
+ * Devoplus yapay zekâsına bir iş gönderir (`POST One/services/ai`, scope `ai.use`). Kullanıcı, portal ve uygulama
+ * istekle GÖNDERİLMEZ — backend bunları doğrulanmış platform bağlamından alır.
+ *
+ * ```ts
+ * const { output } = await completeAi(api, ctx, { task: 'summarize', input: metin, lang: 'tr' })
+ * ```
+ */
+export async function completeAi(api, ctx, request) {
+    // Kullanıcı isteği, ajan aracı (kişi adına) ve arka plan işi (uygulama kimliğiyle; `jobs.services` + kurulum onayı).
+    requireServiceScope(ctx, AI_SCOPE);
+    const body = buildAiRequest(request);
+    const raw = await api.request('One/services/ai', { method: 'POST', body: JSON.stringify(body) });
+    return normalizeAiResult(raw);
+}
+/** `ai.complete(api, ctx, istek)` — `completeAi` ile aynı. */
+export const ai = { complete: completeAi };
+//# sourceMappingURL=ai.js.map

package/dist/ai.js.map

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

package/dist/audit.d.ts

@@ -0,0 +1,21 @@
+import type { BackendClient } from './backend.ts';
+import { type OneContext } from './context.ts';
+export declare const AUDIT_ACTION_MAX_LENGTH = 64;
+export declare const AUDIT_TARGET_MAX_LENGTH = 200;
+export declare const AUDIT_DATA_MAX_BYTES = 4096;
+export interface AuditResult {
+    /** Kayıt backend denetim yazıcısına TESLİM edildi mi (yazıcı best-effort — "diske yazıldı" değil "kabul edildi"). */
+    recorded: boolean;
+}
+/** Sunucuya giden gövdeyi doğrular ve kurar; hatalı girdi fırlatır (uzak yazmadan ÖNCE, istek hiç gitmez). */
+export declare function buildAuditRequest(action: string, target?: string, data?: Record<string, unknown>): {
+    action: string;
+    target?: string;
+    data?: Record<string, unknown>;
+};
+/**
+ * Kritik kullanıcı işlemini Devoplus denetim günlüğüne yazar (console izi + backend). Aktör, portal ve uygulama
+ * istekle GÖNDERİLMEZ — backend bunları doğrulanmış platform bağlamından alır.
+ */
+export declare function recordAudit(api: Pick<BackendClient, 'request'>, ctx: OneContext, action: string, target?: string, data?: Record<string, unknown>): Promise<AuditResult>;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAGxD,eAAO,MAAM,uBAAuB,KAAK,CAAA;AACzC,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAC1C,eAAO,MAAM,oBAAoB,OAAO,CAAA;AAIxC,MAAM,WAAW,WAAW;IAC1B,qHAAqH;IACrH,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,8GAA8G;AAC9G,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CA0BtK;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,EACnC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,WAAW,CAAC,CActB"}